governance
为AI编码代理提供项目治理技能,管理架构决策与变更请求。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:governance。 它的用途是:为AI编码代理提供项目治理技能,管理架构决策与变更请求。 完整的 Skill 内容见:https://321skill.com/skills/governance/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我们决定将数据库从MySQL迁移到PostgreSQL,请为此创建一个架构决策记录(ADR)。” 它会引导你填写决策背景、各种选项的权衡比较,并生成一份结构化的ADR文档。或者,在编码中途对AI说“/checkpoint-commit”,它会为当前未提交的更改创建一个检查点提交,并与相关的变更请求关联。
介绍
该项目提供了一套可复用的AI代理技能,旨在解决软件开发项目中决策记录和变更管理混乱的问题。它让AI代理能够自动创建结构化的架构决策记录(ADRs)和变更请求(CRs),并支持创建检查点提交来保存工作进度,从而将项目治理流程自动化、规范化。
使用方式非常简单,通过Skills CLI工具即可一键安装到Claude Code等AI编码代理中。安装后,AI代理便具备了在项目中进行决策记录、变更追踪和进度保存的能力,用户可以通过自然语言指令或预设的Slash命令来触发这些功能。
这套技能非常适合需要管理复杂项目、追求代码历史清晰可追溯的开发者团队。无论是独立开发者、技术负责人还是项目管理者,都能借助AI代理的力量,轻松维护高质量的项目文档和变更历史。
建议在项目初期或重构阶段引入此技能,以建立良好的治理习惯。需要注意的是,AI生成的文档和记录仍需人工复核关键内容,以确保其准确性和适用性。
核心特点
与同类技能相比,其核心区别在于“自举”(Dogfooding)实践,即该仓库自身就使用其治理技能来管理所有变更,提供了真实、可验证的CR实例库。同时,它深度集成了Claude Code的提示钩子(Hooks),能实现检查点提交的自动化触发。
注意事项
不适合仅需快速原型验证、无需文档记录或变更流程极其简单的个人微型项目。
常见问题
这个技能能自动创建Git提交吗?
可以,checkpoint-commit技能能创建链接到变更请求的检查点提交,并可配置钩子自动触发。
安装后如何让AI代理使用治理功能?
安装后,AI代理即具备相关能力,可通过对话指令(如“为此决策创建一份ADR”)或使用/checkpoint-commit等Slash命令来调用。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/governance/raw/index.md 读取 governance 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/governance/raw/index.md(查看排版版本)