技能使用指南

constitution（项目治理章程）Skill 是什么？怎样用 AI 自动生成项目治理规则？

constitution（项目治理章程）Skill 通过并行扫描安全、架构、代码质量、测试四大视角，从真实代码模式中提炼 L1/L2/L3 三级治理规则并写入项目章程，规则有证据、可迭代、需人工确认批准。本文详解一键安装步骤、使用方法、竞品对比与典型场景，帮你快速为团队与 AI 协作立下统一规矩。

项目治理章程Skillconstitution
8 个章节 约 13 分钟阅读 AI 智能生成

项目治理章程Skill：让项目规则从代码里“长”出来，而不是靠开会拍脑袋

  • 它是什么：一个“治理协调器”型 AI 技能，通过并行调度多个发现代理扫描代码库，把真实存在的模式提炼成可执行的治理规则，并写入项目根目录的 CONSTITUTION.md。
  • 最大的不同：先发现、后立规。没有代码证据就不写规则，从根本上避免“拍脑袋规范文档”。
  • 规则有等级：L1（必须／AI 可自动修复）、L2（应该／需人工判断）、L3（可能／建议），共三级，直接决定规则的阻塞能力和处理方式。
  • 支持聚焦与迭代：可通过可选参数指定焦点领域（如“安全和测试”“Next.js 的架构模式”），也可在已有章程基础上增量更新。
  • 有人工把关：写章程之前必须由用户确认规则，章程变更影响所有后续工作，不会悄悄改。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能中文名：项目治理章程Skill 技能英文名：constitution 技能ID：11736

它解决的问题非常具体：几乎每个项目都有“团队约定”，但绝大多数停留在 README 的一句话、某位老员工的记忆，或者一份早已和代码脱节的规范文档里。结果是新人反复踩坑、AI 编码助手每次都要被重复“教育”、代码评审靠个人经验而非统一标准。

这个技能把“项目立宪”变成一次可复用的自动化流程：读取项目上下文（CLAUDE.md、docs/specs/ 中的规范文档、已有的 CONSTITUTION.md）、并行调度安全／架构／代码质量／测试四个发现视角、把发现结果去重分类成三级规则、经用户确认后写入 CONSTITUTION.md。

“一键安装”的思路与步骤：

  1. 确认前提：你的 AI 编程环境需要支持技能（Skill）机制，并且当前会话对项目根目录有读写权限——因为技能最终要写入 CONSTITUTION.md。同时建议项目里已有基本的代码库（空仓库没有可发现的模式，规则也就无从谈起）。
  2. 找到安装入口：在技能市场／技能库中以英文名 constitution 或技能ID 11736 搜索并安装（具体命令、入口路径以官方说明为准）。
  3. 授权工具：该技能声明的可用工具包括 Task、TodoWrite、Bash、Grep、Glob、Read、Write、Edit、AskUserQuestion。安装后确认这些工具已放开，否则并行发现与文件写入会失败。
  4. 验证是否生效：在会话中直接调用该技能（可带焦点领域参数，例如 安全和测试）。若生效，你会先看到多个发现视角被同时启动，随后收到按类别整理、待你批准的规则清单；批准后项目根目录出现 CONSTITUTION.md，并返回包含 action、path、categories、totalRules、levelDistribution 的结构化摘要。
  5. 回归验证（可选）：技能内置阶段 4 验证入口，会调用 Skill(start:validate) constitution 并报告合规性发现。

2. 该技能的主要功能和特点

  • 发现驱动的规则生成：技能的硬约束是“没有代码库证据不写规则”。每条规则背后都必须有一次真实发现的模式作为支撑，并附 文件:行 形式的证据引用。
  • 并行多视角扫描：安全（认证方式、密钥处理、输入校验、注入防护、CORS）、架构（层次结构、模块边界、API 模式、数据流、依赖关系）、代码质量（命名约定、导入模式、错误处理、日志、代码组织）、测试（测试框架、文件模式、覆盖要求、模拟方法）四个视角在单个响应中同时启动。
  • 三级规则体系：L1「必须」会阻塞且由 AI 自动纠正，覆盖安全、正确性、架构等关键规则；L2「应该」会阻塞但需人工判断；L3「可能」不阻塞，属于风格偏好与建议。
  • 创建与更新双模式：自动检查根目录是否已有 CONSTITUTION.md，首次匹配即路由——不存在则走“创建新章程”，存在则走“更新现有章程”（添加、修改、移除规则或查看当前章程）。
  • 焦点领域映射：传入“安全”就只跑安全视角，传入“测试”“架构”“代码质量”同理；传入框架名（如 React、Next.js）则选中基于框架模式的相关子集；留空或输入“全部”则跑所有视角。
  • 人工确认闭环：规则按类别呈现后调用 AskUserQuestion，由你批准或修改，章程不会被单方面改写。
  • 渐进式披露的参考材料：template.md（创建新章程时提供带 [需要发现] 标记的结构）、examples/CONSTITUTION.md（想先看示例时）、reference/rule-patterns.md（查规则模式、范围示例与排错时），按需加载而非一次性灌入。

和普通工具比强在哪：ESLint、Prettier 这类工具是“事后检查”，规则由人预先写好；这个技能是“事前立宪 + 有据可依”，规则从既有代码里反向提炼，因此天然贴合项目现状，且覆盖的不只是语法风格，还包括架构边界、安全实践与测试策略。

3. 如何使用该技能？

  1. 准备项目上下文：确保项目根目录有 CLAUDE.md（架构、约定、优先级），如有 docs/specs/ 规范文档一并保留，技能会在行动前阅读并内化。
  2. 触发技能：在 AI 会话中调用 constitution 技能。可带一个可选的焦点领域参数。
    • 输入示例一（全量）：不带参数，或传 全部
    • 输入示例二（聚焦）：安全和测试
    • 输入示例三（框架）：Next.js 的架构模式
  3. 等待阶段 1 判定：技能检查根目录是否存在 CONSTITUTION.md，决定走创建（2A）还是更新（2B）。
  4. 接收并行发现结果：多个代理同时输出形如「类别 / 模式：…… / 证据：文件:行 / 提议规则：[L1] ……」的发现条目。
  5. 审阅综合后的规则：技能会收集所有发现、对重叠模式去重、按 L1／L2／L3 分类、按类别分组后呈现给你。此时不要直接放行，重点看两件事——证据引用是否真实、等级定得是否合理（把 L3 的风格建议错标成 L1 会拖慢整个团队）。
  6. 确认或修改：通过 AskUserQuestion 批准规则或提出修改意见。若走更新模式，选项中会出现“添加新规则／修改现有规则／移除规则／查看当前章程”。
  7. 写入章程：批准后，技能将 CONSTITUTION.md 写入项目根目录，并输出结构化结果：action（创建/更新）、path（CONSTITUTION.md）、categories（各分类及规则数，如“安全：6 条”）、totalRules（规则总数）、levelDistribution（L1／L2／L3 各自数量）。这份摘要非常适合直接贴进 PR 描述或团队周报。
  8. 可选验证：选择立即运行验证，技能会调用 Skill(start:validate) constitution 并报告当前代码与章程的合规性差距。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
constitution（项目治理章程Skill） 从代码库反向提炼治理规则的“立宪器” 并行四视角发现、证据引用、L1/L2/L3 分级、创建与更新双模式、人工确认、可选合规验证 需支持 Skill 的 AI 环境与根目录写权限；规则质量依赖代码库成熟度 遗留项目接手、多人 + AI 协作、需要统一评审标准 优势：规则有据可依、覆盖架构与安全等非语法维度、可迭代；不足：空仓库无模式可发现，仍需人工审阅等级划分
ESLint / Prettier 等静态检查工具 代码层面的自动化检查与格式化 语法规则校验、自动修复、格式化 需写配置文件与插件，规则靠人工维护 语法风格统一、低级错误拦截 优势：确定性高、CI 集成成熟；不足：不懂架构边界与业务约定，规则与项目现状易脱节
手写 CONTRIBUTING.md / 规范文档 传统团队约定载体 文字化描述约定与流程 零门槛，但维护成本高 小团队、流程简单 优势：灵活、可读性好；不足：与代码脱节、无法验证、新人仍靠口口相传
CLAUDE.md / AGENTS.md 等单一提示文件 面向 AI 助手的项目上下文说明 提供架构与偏好描述 低，直接写文件 让 AI 快速理解项目 优势：轻量直接；不足：缺少分级与证据链，规则约束力弱，AI 是否遵守不可控

5. 该技能的典型应用场景与实际体验情况

场景一：接手遗留项目的新架构师 痛点是不敢动代码——不知道哪些模块是禁区、哪些写法是刻意的。使用方式：不带焦点参数跑一次全量发现，得到一份带 文件:行 证据的章程。实际体验是“上手难度低、信息密度高”，尤其证据引用让人敢于信任结论；注意首次运行耗时会明显长于普通对话，因为要并行扫描多个视角。

场景二：多人 + AI 协作的编码团队 痛点是每位成员都要向 AI 助手重复解释同一套约定，评审标准因人而异。使用方式：把章程生成纳入项目初始化流程，之后每次 AI 编码都以此为准。实际体验是规则一旦落到 L1，AI 会自动纠正而非事后返工；建议把 totalRules 与 levelDistribution 摘要放进 PR，方便评审时对齐预期。

场景三：安全与合规加固 痛点是安全检查常被当成上线前的突击项。使用方式：传入焦点领域 安全和测试，只跑安全与测试视角，产出认证方式、密钥处理、输入校验、注入防护、CORS 相关规则。注意这类规则应尽量定为 L1（必须、可自动修复），但密钥管理等场景仍需人工判断，标 L2 更稳妥。

场景四：框架迁移与架构收敛 痛点是从旧架构迁到 Next.js 时，新旧写法长期共存。使用方式：传入 Next.js 的架构模式，技能会选中基于框架模式的相关子集。更新模式在这里格外好用——迁移过程中分批添加规则，而不是一次性重写整份章程。

6. 该技能能为用户带来的价值

  • 把隐性知识变成显性资产：团队里“老员工脑子里的规矩”第一次以可查阅、可验证、可迭代的文件形式沉淀下来。
  • 大幅压缩规范制定时间：原本需要几轮会议、数天调研才能形成的规范草案，在一次技能调用 + 一次人工确认内完成，且每条规则自带代码证据。
  • 降低新人上手与 AI 协作门槛：新成员不必再靠“读代码猜约定”，AI 助手也不必被反复口头指导，规则文件即共识。
  • 让评审从主观变客观：L1／L2／L3 三级划分明确了“什么必须改、什么可以商量”，减少评审中的无谓争论。
  • 长期可维护：章程不是一次性文档，更新模式让规则随代码演进持续校准，避免规范三个月后就过期。

7. 常见问题 FAQ

Q1：怎么安装这个技能？ 在支持 Skill 机制的 AI 编程环境中，以英文名 constitution 或技能ID 11736 在技能市场／技能库中搜索安装，具体命令与入口以官方说明为准。安装后请确认 Task、Read、Write、Grep、Glob、AskUserQuestion 等工具已授权，否则无法完成并行发现与章程写入。

Q2：这个技能收费吗？ 技能本身的使用费用取决于你所使用的 AI 平台与订阅方案，本技能详情中未包含定价信息，请以官方说明为准。

Q3：它适合谁用？ 最适合三类人：接手陌生或遗留代码库的工程师、需要统一多人 + AI 协作标准的团队负责人，以及要落地安全／测试／架构规范的平台或质量团队。如果项目刚初始化、代码量极少，可发现模式有限，价值会打折。

Q4：它会不会自动改我的代码？ 不会。它的产出是一份 CONSTITUTION.md 规则文件，写入项目根目录，且写入前必须经过你确认。等级系统中的“L1 自动修复”描述的是规则的属性——这类规则允许 AI 后续自动纠正，而非该技能本身去改代码。

Q5：和手写规范文档、ESLint 怎么选？ 不冲突，建议组合使用：这个技能负责“立宪”——从代码库提炼架构、安全、质量、测试四个维度的治理规则；ESLint／Prettier 负责语法层面的确定性检查；手写文档负责流程与价值观描述。若只想统一代码风格，静态检查工具更轻；若需要覆盖架构边界与团队评审标准，章程类方案更合适。