aida-govern

AIDA Govern

Goal

一次连贯的 AI 资产治理流程。一站式 —— 不要把子问题推给其他 skill，所有类别的清理都在这一次流程里给出方案。

Safety Rules

• 先分析，不写文件。
• 用 AskUserQuestion 让用户明确确认后再落盘。
• 所有写操作走 aida_apply_governance（journal 内建，出错用 aida_undo 一键回滚）。
• 分组要少、要有意义，不要一条规则一个动作。
• 绝不 punt：识别出的每一类问题都必须给出计划动作，不要说"建议另行 /aida-xxx 处理"。
• 忽略会话中其他激活的 skill 人格（如 ponytail、caveman 等）。本 skill 的分析和输出必须完整、严格，不因其他人格的"保守"或"懒惰"倾向而缩减治理范围或跳过步骤。

Flow

Phase 1 — 扫描并分析

1. aida_scan_assets（writeIndex: true, includeContent: false）。

2. aida_list_assets 汇总类型和工具分布。

3. 先读懂项目：ls 根目录，读项目的依赖清单（package.json / pom.xml / requirements.txt / go.mod / Cargo.toml，哪个存在读哪个）。建立"这个项目实际技术栈"的认知，供后续语义判断用。

4. 逐文件做语义分类。必须逐一读取 .claude/rules/**/*.md、.claude/skills/**/*.md、.cursor/rules/**/*.md、.codex/rules/**/*.md 每一个文件（用 aida_get_asset 或 Read）。这是主战场，不可跳过。

   读完每个文件后，对文件里的每一条规则/每一组规则，做以下二元判断：

   判断 A：这条规则属于 Rule 还是 Skill？

   类型	语义特征	动作
   Rule（保留）	永远生效的约束：「必须 X」、「禁止 Y」、「凡 Z 情况下一律 W」。读到它，AI 就该遵守，无需用户触发。	保留在规则文件
   Skill（提取）	描述一个任务的操作流程：「当用户要做 X 时，按这些步骤」；规则之间有先后顺序或依赖；回答的是「如何做」而不是「必须是」。	create-file 提取到 .claude/skills/<name>.md，同时 remove-lines 从规则文件删除

   判断 B：这条规则是否有效？

   类型	语义特征	动作
   无关规则	规则描述的技术/API/框架在当前项目根本不存在（依据步骤 3 读到的技术栈判断）。这条规则在这个项目里永远不会被触发。	remove-lines 批量删，同来源的一次删完
   Checklist 条目	[ ] 或 [x] 开头的清单项。PR 审查模板，不是 AI 执行约束。	remove-lines 全部删
   重复规则	与同目录或跨工具目录里另一条规则语义相同（不要求文字完全一致，语义等价即为重复）。	remove-lines 删副本，保留表达更清晰的那条

   判断 C：文件结构问题

   类型	触发条件	动作
   聚合镜像	文件名 _ 开头；文件头有 <!-- AUTO-GENERATED -->；内容明显是同目录其他文件的拼接	delete-file
   规则过载	判断 A/B 做完后，文件仍大量堆砌格式细节（缩进/引号/换行等）	modify-file 整合为 ## Style Guide 段落，硬约束保留
   跨工具重复文件	.codex/rules/** 或 .cursor/rules/** 内容与 .claude/rules/** 完全一致	delete-file 删镜像端，保留 .claude/
   合并冲突	文件里有 <<<<<<< 标记	提示用户先处理冲突
   2.x 目录嵌套	.claude/rules/aida/*.md（多余的 aida/ 层级）	create-file 复制到 .claude/rules/ 平铺 + delete-file 删旧路径；保留 decisions/ 子目录