核心概念
阶段规范
每个功能都必须经过强制阶段推进，不可跳过。
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 进程。不可跳过。
搜索与诊断
用本地索引搜索治理制品，并通过带代码的诊断及时发现偏差。
Loop 与 TUI Cockpit
用 loop 协调本地执行 round，并通过只读终端 cockpit 检查项目状态。
参考
CLI 命令
验证
check
govctl check
✓ All 12 RFCs valid
✓ All 8 ADRs valid
✓ All 5 work items valid
发现
search
govctl search cache
govctl search RFC-0002 -o json
govctl search migration --type rfc --type adr --tag cli -n 5
创建工件
new
govctl rfc new "Feature Title"
govctl adr new "Decision Title"
govctl work new "Task Title"
执行 Loop
loop
govctl loop list open
govctl loop start WI-2026-06-07-001 WI-2026-06-07-002
govctl loop run
govctl loop show
TUI Cockpit
tui
govctl tui
✓ overview · artifacts · search
✓ loops · DAG · diagnostics
生命周期
lifecycle
govctl rfc finalize RFC-0001 normative
govctl rfc advance RFC-0001 impl
govctl rfc advance RFC-0001 test
govctl rfc advance RFC-0001 stable
适用
适用于谁
适合
- 对 AI "先写代码，后思考" 模式感到沮丧的团队
- 不想推倒重来、但需要补齐治理的存量项目
- 需要 AI 生成代码审计轨迹的组织
- 相信规范能够加速开发的开发者
不适合
- "快速行动，打破常规" 的工作流
- 没有审查流程的项目