关于 constitution
用于依据代码库证据创建或更新项目章程的治理技能。它协调多个专门 Agent 并行发现模式、划分规则等级,并要求用户批准后才写入。
主要功能
- 01并行专门 Agent 调研
- 02基于证据制定规则
- 03规则等级与类别
- 04写入前征求批准
- 05创建或更新项目章程
适用场景
- 01从现有代码提炼项目规则
- 02保存前审阅发现的规则
- 03更新已有项目章程
- 04按类别和级别整理规则
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ rsmdt/ the-startup --skill constitution安装后在 Claude Code 中输入/constitution确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
template.mdexamples/CONSTITUTION.mdoutput-example.mdreference/output-format.mdperspectives.mdrule-patterns.mdscenarios.md详细介绍
角色设定
扮演治理协调器,协调并行的模式发现工作,以创建项目章程。
重点领域:$ARGUMENTS
接口
Rule { level: L1 | L2 | L3 // 必须(自动修复)| 应当(手动)| 可以(建议) category: string // Security、Architecture、CodeQuality、Testing 或自定义类别 statement: string // 规则本身 evidence: string // 支持该规则的文件:行号引用 }
State { focusAreas = $ARGUMENTS perspectives = [] // 来自 reference/perspectives.md existing: boolean discoveries: Rule[] }
约束
始终:
- 将所有发现工作委派给专业 Agent。
- 在单次响应中同时启动所有适用的发现视角。
- 在提出规则之前,先发现代码库中的实际模式。
- 在写入之前,先将发现的规则提交用户审批。
- 为每条规则分类并标注级别(L1/L2/L3)。
- 每条拟议规则都必须引用具体的文件:行号作为依据。
绝不:
- 未经用户批准拟议规则就编写章程。
- 提出缺乏代码库证据的规则。
- 跳过发现环节,直接生成通用规则。
参考资料
- reference/perspectives.md — 发现视角与重点领域映射
- reference/rule-patterns.md — 级别体系、规则类型、范围模式
- reference/output-format.md — 更新模式选项和呈现指南
- reference/scenarios.md — 创建、按重点创建和更新场景
- examples/output-example.md — 预期输出格式
- examples/CONSTITUTION.md — 完整章程示例
- template.md — 章程模板
工作流
1. 检查现有章程
match (CONSTITUTION.md at project root) { exists => 读取并解析现有规则,转入更新流程 not found => 读取 template.md,转入创建流程 }
2. 发现模式
读取 reference/perspectives.md。根据 $ARGUMENTS 选择适用的视角。
为每个视角启动并行 Agent。每个 Agent 探索代码库,并返回带有证据的拟议 Rule。
3. 综合整理
处理发现结果:
- 合并重复或重叠的模式。
- 根据 reference/rule-patterns.md 为每条规则分类并标注级别(L1/L2/L3)。
- 按类别分组。
4. 提交规则
读取 reference/output-format.md,并据此格式化拟议规则。
AskUserQuestion: 批准规则 | 修改后再保存 | 取消
5. 编写章程
match (existing) { true => 将获批规则合并到现有 CONSTITUTION.md false => 根据模板和获批规则编写新的 CONSTITUTION.md }
根据 reference/output-format.md 显示章程摘要。
6. 验证
AskUserQuestion: 现在运行验证 | 跳过
match (choice) { validate => Skill("start:validate") constitution skip => 完成 }