用途：通过 GSD 无头模式自主构建软件产品，覆盖从写规格说明、启动构建、轮询完成状态到处理阻塞的完整生命周期。使用者无需自己写应用代码，子进程会负责规划、编码、测试与 git 提交。
主要能力：支持从规格文件创建里程碑、自动运行队列任务、单步执行、即时查询状态、事件流式监控、注入答案与密钥、硬性转向计划、跳过或撤销单元、排队里程碑、查看历史、健康检查，以及代码库文档、评审、审计与 UAT 等工作流。
必要性用法：标志需放在命令之前，形如 gsd headless [--flags] [command] [args]，命令后的标志会被忽略。JSON 输出走 stdout，进度走 stderr，解析 JSON 时加 2>/dev/null。退出码含义：0 成功、1 错误或超时、10 阻塞需人工介入、11 已取消。使用 query 轮询，约 50 毫秒且无 LLM 成本。注意预算，跟踪 query 结果中的 cost.total。每个 GSD 项目需要独立目录和 .gsd/ 文件夹。
常用命令示例： mkdir -p /tmp/my-project && cd /tmp/my-project && git init gsd headless --output-format json --context spec.md new-milestone --auto 2>/dev/null cd /path/to/project gsd headless query | jq '{phase: .state.phase, progress: .state.progress, cost: .cost.total}' gsd headless --output-format json auto 2>/dev/null gsd headless --answers answers.json --output-format json auto 2>/dev/null
状态文件：GSD 将状态保存在 .gsd/gsd.db，并据此渲染 PROJECT.md、REQUIREMENTS.md、DECISIONS.md、KNOWLEDGE.md、STATE.md 及 milestones 目录下的 CONTEXT、ROADMAP、SUMMARY、PLAN 等文件。数据库是唯一事实来源，渲染文件仅供参考，不要直接编辑，当前状态请用 gsd headless query 获取。
适用场景：需要以子进程方式自动化推进软件项目的构建流程，包括从零构建、监控运行中的构建、按决策点单步执行等。
限制：标志位置、stderr 重定向、退出码与预算等规则必须遵守；单项目单目录；未提供的收费、价格或平台信息暂无资料说明。