核心概念
阶段规范
每个功能都必须经过强制阶段推进,不可跳过。
SPEC
RFC must be normative locked
IMPL
Code must match spec locked
TEST
Tests must pass gates locked
STABLE
Bug fixes only locked
No shortcuts. No going back.
能力
govctl 做什么
RFC 管理
创建、跟踪和强制执行 RFC 文档,作为所有功能的唯一真相来源。
ADR 追踪
架构决策记录,具有明确的后果和可追溯性。
工作项
任务链接回治理工件。每个变更都由规范授权。
阶段门禁
强制执行 spec → impl → test → stable 进程。不可跳过。
验证
持续检查确保代码符合规范。偏差会被立即检测。
AI 集成
与任何支持 shell 的 AI 代理兼容。Claude、Cursor、Codex——全部支持。
参考
CLI 命令
验证
check
govctl check
✓ All 12 RFCs valid
✓ All 8 ADRs valid
✓ All 5 work items valid
列表
list
govctl rfc list
govctl adr list
govctl work list
创建工件
new
govctl rfc new "Feature Title"
govctl adr new "Decision Title"
govctl work new "Task Title"
生命周期
lifecycle
govctl rfc finalize RFC-0001 normative
govctl rfc advance RFC-0001 impl
govctl rfc advance RFC-0001 stable
适用
适用于谁
适合
- 对 AI "先写代码,后思考" 模式感到沮丧的团队
- 规范与实现经常偏离的项目
- 需要 AI 生成代码审计轨迹的组织
- 相信规范能够加速开发的开发者
不适合
- "快速行动,打破常规" 的工作流
- 没有审查流程的项目