govctl
为AI辅助开发提供治理框架的CLI工具，确保代码变更可审查、可追踪。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：govctl。 它的用途是：为AI辅助开发提供治理框架的CLI工具，确保代码变更可审查、可追踪。 完整的 Skill 内容见：https://321skill.com/skills/govctl/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“为我们的用户登录模块创建一个RFC，描述双因素认证的需求和约束。” 它会引导你使用 `govctl rfc create` 命令，生成结构化的需求文档。然后你可以说：“基于这个RFC，创建一个实现双因素认证的工作项。” AI会使用 `govctl work create` 来生成包含验收标准的具体任务，并将代码实现与治理工件关联起来。
介绍
govctl 是一款面向严肃使用AI进行软件开发的团队的治理即代码（governance-as-code）CLI工具。它旨在解决AI辅助开发中常见的“生成即完成”问题，即代码变更缺乏规范流程、设计决策散失在聊天记录中、代码与需求脱节，最终导致交付质量不可控。
该工具通过在代码仓库中引入一个基于文件的治理层来工作。它将开发流程规范化为RFC（需求说明）、ADR（架构决策记录）、Work Item（工作项）和Verification Guard（验证门禁）等可追踪的工件。这些工件以TOML文件形式存储在 gov/ 目录下，便于版本控制和代码审查。
govctl 非常适合那些希望将AI生成的大量代码变更纳入规范化、可审计开发流程的团队，特别是项目经理、技术负责人和全栈开发人员。它尤其适用于已有一定代码基础的“棕地”项目，帮助团队在引入AI工具的同时，维持代码质量和决策的透明度。
使用建议是，团队应从关键模块或新功能开始试点，逐步将RFC和ADR的编写与评审融入现有工作流。注意事项是，它并非一个代码生成器，而是治理框架，需要团队投入时间定义初始的治理规则和验收标准。
核心特点
与大多数优化代码生成的AI工具不同，govctl专注于优化交付流程，通过将治理规则代码化并置于仓库内，使AI驱动的变更变得可审查、可追踪和可门控。其CLI接口设计稳定且易于AI代理操作，可直接在现有项目中工作，无需依赖外部服务。
注意事项
不适合追求快速原型、无需严格流程验证的个人或小型实验性项目。
常见问题
govctl 是代码生成工具吗？
不是，它是一个治理框架CLI，用于管理AI辅助开发过程中的需求、决策、任务和验证，确保生成代码的质量和可追溯性。
govctl 能在已有项目中用吗？
可以，它专为“棕地”项目设计，通过添加 `gov/` 目录和治理工件来工作，不破坏现有代码结构。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/govctl/raw/index.md 读取 govctl 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/govctl/raw/index.md（查看排版版本）