govctl logo govctl
已发布 v0.4.0

govctl

用于 RFC 驱动的 AI 辅助软件开发的治理 CLI。 为每个功能强制执行阶段规范。

Install
cargo install govctl
# Or with TUI dashboard
cargo install govctl --features tui

核心概念

阶段规范

每个功能都必须经过强制阶段推进,不可跳过。

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 生成代码审计轨迹的组织
  • 相信规范能够加速开发的开发者

不适合

  • "快速行动,打破常规" 的工作流
  • 没有审查流程的项目