Auto-Claude 是一个自主编码框架，本条目是其完整命令行界面参考，介绍如何通过 CLI 命令运行规格（spec）、管理构建、检查状态以及使用相关功能。
用途
Auto-Claude CLI 用于以规格驱动的方式执行自主编码任务：先创建描述任务的 spec，再运行自主构建，随后在隔离工作区中审查与测试改动，最后合并到项目。也支持批量创建与按序运行多个 spec。
主要能力
规格创建：可通过 python spec_runner.py --interactive 交互式创建规格（推荐用于复杂任务），或通过 python spec_runner.py --task "..." 从任务描述快速创建；支持 --complexity simple/standard/complex 强制复杂度，支持 --continue 继续被中断的规格创建。
复杂度分档：SIMPLE 为 3 个阶段，适用于 1-2 个文件、单服务、无集成（如 UI 修复、文本改动）；STANDARD 为 6-7 个阶段，适用于 3-10 个文件、1-2 个服务、少量集成（如功能、bug 修复）；COMPLEX 为 8 个阶段，适用于 10+ 文件、多服务、外部集成。
构建运行：python run.py --list 列出所有规格及状态；--spec 指定运行某个规格（可用编号或完整名称）；--max-iterations 限制迭代次数用于测试；--skip-qa 跳过自动 QA。
QA 校验：--qa 手动运行 QA 校验，--qa-status 查看 QA 状态。QA 循环为：QA Reviewer 检查验收标准，若发现问题则生成 QA_FIX_REQUEST.md，QA Fixer 应用修复，循环重复直到通过，最多 50 次迭代。
工作区管理：可在隔离工作区 .worktrees/auto-claude/{spec-name}/ 中测试功能；--review 查看改动，--merge 合并到项目，--discard 丢弃（带确认）。
规格校验：python validate_spec.py --spec-dir specs/001-feature --checkpoint all 按所有检查点校验，--checkpoint requirements 校验指定检查点。
交互控制：构建过程中按一次 Ctrl+C 暂停并添加指令，连按两次立即退出。也支持文件控制：touch specs/001-name/PAUSE 在当前会话后暂停，向 HUMAN_INPUT.md 写入人工指令，删除 PAUSE 文件继续。
使用方式
所有 CLI 命令在 apps/backend/ 目录下运行，并需先激活虚拟环境：Linux/macOS 上执行 source .venv/bin/activate，Windows 上执行 .venv\Scripts\activate。
环境变量：CLAUDE_CODE_OAUTH_TOKEN 为必填（来自 claude setup-token 的 OAuth token）；AUTO_BUILD_MODEL 可选，默认 claude-opus-4-5-20251101；DEFAULT_BRANCH 可选，默认自动检测，作为 worktree 基础分支；DEBUG 可选，默认 false；DEBUG_LEVEL 可选，默认 1，取值 1-3；GRAPHITI_ENABLED 可选，默认 true，启用记忆系统；LINEAR_API_KEY 可选，用于 Linear 集成。
典型流程示例：先用 python spec_runner.py --task "Add user profile page with avatar upload" 创建规格；再用 python run.py --spec 001 运行构建；接着 python run.py --spec 001 --review 审查改动；在 worktree 中测试；最后 python run.py --spec 001 --merge 合并。
每个规格在 .auto-claude/specs/XXX-name/ 下创建目录，包含 spec.md（功能规格）、requirements.json（结构化需求）、context.json（发现的代码库上下文）、implementation_plan.json（基于子任务的计划）、qa_report.md（QA 校验结果）、QA_FIX_REQUEST.md（被拒绝时需修复的问题）、PAUSE（暂停文件，如存在）、HUMAN_INPUT.md（人工指令）。
适用场景
完整的特性开发、快速 bug 修复、批量处理多个规格等。文档建议任务描述应具体可操作（如明确平台、交互与路由），避免模糊描述；复杂度选择上，简单改动选 simple，多数功能与修复选 standard，多服务与外部集成选 complex。调试失败构建时可设置 DEBUG=true DEBUG_LEVEL=3 启用详细日志、用 --list 查看规格状态、查看 qa_report.md。
限制
资料未提供该工具的收费、价格、许可证、支持平台限制等商业与运行限制信息，这些内容暂未提供。相关技能包括 auto-claude-spec、auto-claude-build、auto-claude-workspace、auto-claude-troubleshooting。