使用 SpecGate
仅启动安装
当 specgate-project-setup 在仅根目录的 skills.sh 安装后不可用时使用。检查 command -v specgate（PowerShell：Get-Command specgate）。如果不存在，说明 skills.sh 仅提供指令。在 macOS、Linux 或 WSL2 上，显示以下内容并等待明确批准：
curl -fsSL https://raw.githubusercontent.com/thanhtung2693/specgate/main/scripts/install-cli.sh | sh
原生 Windows：使用 https://github.com/thanhtung2693/specgate/releases/latest；切勿自行编造 PowerShell。之后记录 specgate --version。
仅信任来源为 thanhtung2693/specgate 且路径为 plugins/skills/specgate/SKILL.md 的锁定文件，位于项目 skills-lock.json 或全局 ~/.agents/.skill-lock.json 中。显示其匹配命令并等待批准：
npx skills remove specgate -y
npx skills remove specgate -g -y
切勿直接编辑或删除 skills.sh 文件或锁定文件。询问 IDE 和作用域，然后预览、安装和验证：
specgate plugins install --agent <codex|claude|cursor> [--project-local] --dry-run --no-input
specgate plugins install --agent <codex|claude|cursor> [--project-local] --no-input
specgate plugins doctor --agent <codex|claude|cursor> [--project-local] --json
遇到原生插件所有权时，停止。未经单独明确批准，不得卸载或禁用它。
要求 IDE 重启并停止后再进行初始化。在 specgate-project-setup 之后继续。
完成：一个由 CLI 管理的插件，健康的 doctor 检查，明确的重启。
路由一个阶段
对于生命周期工作，在执行之前，请精确选择一个阶段：
specgate-project-setup— 为仓库初始化、绑定、安装、刷新或诊断 SpecGate。specgate-work-preparation— 将请求或源规范转换为已批准的 SpecGate 工作项。specgate-work-delivery— 实施、恢复、审查或返工已批准的 SpecGate 工作项。
对于包含工作引用的只读工作或生命周期状态问题，请从权威读取开始：
specgate change status "$WORK_REF" --json
对于其他概念或故障排除问题，请使用最小的相关 CLI 读取。不要强制进入某个阶段或修改记录。
在依赖模式的写入或交接之前，运行 specgate doctor --json。读取 data.mode；切勿从 Docker、URL 或浏览器可用性推断模式。如果 doctor 结果不成功，则报告，而不是猜测。
操作合同
specgateCLI 是唯一的产品状态读写接口。切勿直接检查或编辑 SpecGate 的 SQLite、Postgres、对象存储、部署卷或.specgate/local。仓库源读取仍然允许。- 草稿、解释、摘要和仓库读取保持临时性，直到明确执行 CLI 命令将其持久化。
- 原始创作框架拥有持久源文档：其路径、名称、生命周期和 Git 策略。SpecGate 在原地对其快照。它不会移动、复制、重命名、删除、提交或更改它们的忽略规则。
- 就绪检查并非人工批准。批准、验收和请求的变更仍然是人工决策。仅在人工明确选择并授权该确切决策后才执行决策命令；切勿推断。
- 已批准的上下文包优先于聊天历史、跟踪器文本和陈旧的仓库文档。切勿悄无声息地扩展其范围。
- 遵循精确的标识符和版本。
artifact coverage <artifact-id>是精确版本的证据；切勿按功能名称折叠版本。 - 遵循
change status.data.next_actor和next_command。当下次操作者是人工时，停止并原样移交该命令。 - 本地模式没有 UI URL，并且从不调用
specgate open。在完整模式下，仅使用specgate open ... --print --json返回的 URL；切勿自行构造一个。
有关命令语法，请运行 specgate <command> --help，而不是根据记忆重建标志。