用途：通过 GSD headless 子进程自主构建软件产品。你把规格交给它，它自主完成规划、编码、测试与 git 提交，你不需自己写应用代码。
主要能力：覆盖写规格、启动构建、轮询完成状态、处理阻塞的完整生命周期；支持从头构建、监控轮询、逐步执行三种工作流；提供 query 即时状态快照（约 50ms，无 LLM 成本）、答案与密钥预注入、JSONL 实时事件流、成本追踪与退出码判定。
使用方式：标志需写在命令前，格式为 gsd headless [--flags] [command] [args]，标志写在命令后会失效。JSON 走 stdout，进度走 stderr，解析时用 2>/dev/null。常用命令包括 auto（跑完队列单位）、next（只跑一个单位）、query（即时快照）、new-milestone、dispatch <phase>、stop/pause、steer <desc>、skip/undo、queue、history、doctor、knowledge <rule|pattern|lesson>。如：gsd headless --output-format json --context spec.md new-milestone --auto 2>/dev/null；gsd headless query | jq '{phase: .state.phase, progress: .state.progress, cost: .cost.total}'；预注入答案用 gsd headless --answers answers.json --output-format json auto 2>/dev/null。
退出码：0 成功，1 错误或超时，10 被阻塞（需介入），11 已取消（可用 --resume <sessionId> 恢复）。
项目结构：每个 GSD 项目需独立目录并含 .gsd/ 文件夹，内含 PROJECT.md、REQUIREMENTS.md、DECISIONS.md、KNOWLEDGE.md、STATE.md 及 milestones 下的上下文、路线图、汇总与 slices/tasks 计划文件；完成状态以 ROADMAP.md 和 PLAN.md 的复选框为准，由 GSD 管理，你无需编辑，但可读取了解进度。
适用场景：从规格构建产品、监控运行中的构建、逐步精细控制执行、查看 JSON 输出字段、预供答案或密钥、查询具体命令。
限制：需注意预算，从 query 结果追踪 cost.total 并在长时间运行前设限；JSON 解析必须重定向 stderr；标志位置有严格要求；这些资料未提供具体收费、价格、平台与效果信息。