quick-reference.md

ACCA 配置速查表

快速上手 ACCA 工作流的必备参数和常见组合。

Claude CLI 常用参数

参数	用途	示例
-p "PROMPT"	必选。Headless 模式执行	claude -p "生成代码"
--allowedTools "Read,Edit,Write"	授权工具使用（修改文件时需要）	--allowedTools "Edit"
> file.ext	重定向输出（新建文件最稳）	claude -p "..." > index.html

Codex CLI 常用参数

参数	用途	示例
exec "PROMPT"	执行任务	codex exec "重构代码"
--full-auto	🔥 核心。自动确认所有操作	codex exec "..." --full-auto

黄金组合（Copy & Paste）

# 组合 1: 新建单文件项目 (0 -> 1)
claude -p "创建一个 XXX 游戏，单个 HTML 文件" > game.html

# 组合 2: 大规模重构 (N -> N+1)
codex exec "将 game.html 从 2D 改为 3D" --full-auto

# 组合 3: 调试修复
npm test 2>&1 | claude -p "分析错误并修复" --allowedTools "Read,Edit"

# 组合 4: 多文件参考
cat utils.js main.js | claude -p "参考 utils 重构 main" > main_new.js

# 组合 5: 日志审计（只输出诊断，不写文件）
npm test 2>&1 | claude -p "分析测试失败日志，找出根源" --print

# 组合 6: 增量修改（精准编辑）
claude -p "将 config.yaml 的 timeout 从 30 改为 60" --allowedTools "Read,Edit"

# 组合 7: 安全增量修改（输出 Diff，手动应用）
claude -p "只输出修改后的 drawZombie 函数代码" < game.js
# 然后 Antigravity 用 replace_file_content 应用

常见问题

Q: 为什么 Codex 没有 --allowedTools 参数？ A: Codex 的 --full-auto 已经包含了所有权限，它会自动读写文件。

Q: 为什么 Claude 有时候不生成文件？ A: 检查是否加了 --allowedTools "Write"。如果还不行，用重定向 > file 兜底。

Q: 如何让 CLI 看到项目其他文件的上下文？ A: 用 cat 拼接内容传入，或者在 Prompt 里明确指示 "先读取 xxx.js..."。