3.0 KiB
3.0 KiB
name, description
| name | description |
|---|---|
| update-constitution | Updates AI constitution files (AGENTS.md, config files, permission matrix). Invoke when AI roles, permissions, or workflow rules change. |
更新宪法 Skill
功能
当 AI 角色、权限、工作流规则发生变更时,自动更新所有相关的宪法文件,确保一致性。
触发条件
- AI 角色增加/删除/修改
- 权限矩阵变更(allowed_paths、read_only_paths、forbidden_paths)
- 工作流阶段变更
- 沟通规范变更
- 命名规范变更
执行步骤
1. 识别变更类型
| 变更类型 | 影响文件 |
|---|---|
| 新增 AI 角色 | AGENTS.md、.ai/config/.json、workflow.json、权限矩阵 |
| 权限变更 | AGENTS.md 权限矩阵、.ai/config/*.json |
| 工作流变更 | AGENTS.md 工作流程图、workflow.json |
| 沟通规范变更 | AGENTS.md 沟通规范章节 |
| 命名规范变更 | AGENTS.md 命名规范章节 |
2. 更新宪法文件
按以下顺序更新:
2.1 AGENTS.md
- 更新团队架构图
- 更新角色职责(新增/修改/删除)
- 更新目录权限矩阵
- 更新工作流程图(如适用)
- 更新详细流程说明(如适用)
- 更新 AI 配置文件说明表
2.2 .ai/config/*.json
- 新增/更新对应角色的 JSON 配置文件
- 确保 allowed_paths、read_only_paths、forbidden_paths 与权限矩阵一致
- 确保 responsibilities 与角色职责一致
- 确保 prompt_templates 指向正确的提示词目录
2.3 .ai/config/workflow.json
- 更新 roles 数组
- 更新 stages 数组(新增/修改/删除阶段)
- 确保 actor 字段与角色 ID 一致
3. 更新 Skill 文件
- .trae/skills/ai-collab-setup/SKILL.md - 目录结构、权限矩阵、角色描述、配置文件示例
- .trae/skills/resume-context/SKILL.md - 角色识别逻辑、配置文件读取
4. 验证一致性
- AGENTS.md 权限矩阵 与 .ai/config/*.json 路径配置一致
- AGENTS.md 角色职责 与 .ai/config/*.json responsibilities 一致
- AGENTS.md 工作流程图 与 workflow.json stages 一致
- 所有 JSON 文件语法正确(使用 python -m json.tool 验证)
5. 提交 Git
git add -A
git commit -m "feat(constitution): 更新宪法 - [简要描述变更内容]
- AGENTS.md: [具体变更]
- .ai/config/*.json: [具体变更]
- workflow.json: [具体变更]
- ai-collab-setup/SKILL.md: [具体变更]"
git push
注意事项
- 权限矩阵是核心:所有路径变更必须先更新权限矩阵,再同步到 JSON 配置
- JSON 语法验证:每次修改后必须验证 JSON 语法
- Skill 文件同步:宪法变更后必须同步更新 ai-collab-setup 和 resume-context Skill
- 版本号:重大变更需升级 Skill 版本号
Version: 1.0
Created: 2026-05-23
Based On: SoC_SW AI Programming Project
Purpose: 确保宪法变更时所有相关文件同步更新,避免遗漏