| name | data-governance-layer-triage |
| description | 用于在一次任务、一次需求沟通或一次会话结束后，对刚产生的经验、错误、教训、规则或流程做分诊：判断这条内容是否值得沉淀、为什么会反复出现、应该放到哪一层，以及在当前仓库里应落到 AGENTS.md、目录 README、skill、脚本/checker、hook 候选，还是正式主定义文档。适用于“总结这次会话经验”“记录一个经验/教训”“记住这个错误/教训”“为什么重复出错”“这个问题应该放到哪”“这条规则该写到哪里”“这个流程该做成什么”等场景。 |
Data Governance Layer Triage
概述
给一条新产生的经验、错误、教训、规则或流程找归宿：判断是否沉淀、该进哪一层、在当前仓库该写到哪里。
这个技能只处理单条对象，不做全仓普查，不评价旧内容总体质量，也不直接改文件。
适用场景
- “总结这次会话经验”
- “记录一个经验/教训”
- “还要记录一个经验”
- “补一条经验”
- “登记一个经验”
- “记住这个错误/教训”
- “为什么这个问题总是重复出错”
- “这个问题应该放到哪”
- “这个坑以后别再犯，应该怎么沉淀”
- “这条东西该记到哪里”
- “这条规则该写到哪里”
- “这个坑该不该沉淀”
- “这条流程该进 skill 还是脚本”
- “这条经验是不是该上移到 AGENTS”
- “这条稳定规则为什么不能继续放在
03-工作台”
不适用场景
- “检查当前仓库整体层级是否合理”
- “审查现有 AGENTS、README、skill、脚本写得是否合适”
- “看看哪些旧内容放错层了”
- “给我全仓的分层整改建议”
如果任务是检查当前仓库已有内容是否写得合理、放层是否合适，应改用 layer-governance-audit。
当前仓库落点
- 顶层默认层：
AGENTS.md 为主，CLAUDE.md 为兜底
- 路径作用域层：各目录
README.md
- skill 层：
.codex/skills/*/SKILL.md
- 执行层：
06-工具脚本/*.py、python 06-工具脚本/run_checks.py --scope ...
- hook 候选层：仓库级
.codex/config.toml 与 .codex/hooks/
- 正式主定义层：
00-项目总览/、01-产品架构/、02-PRD文档/、90-归档记录/
核心原则
- 先判断“这条东西值不值得沉淀”，再判断“该放哪一层”
- 先处理单条对象，不扩展成全仓审计
- 先给归宿建议，不直接改文件
- 涉及稳定业务主定义时，优先拆回正式主定义层，不滞留在协作层
输入要求
要求用户至少提供以下信息中的 2 项；若缺失，先补问再分诊：
- 这次想沉淀的具体内容
- 它当前放在哪里
- 它为什么值得沉淀
- 它是否需要真实执行
- 它是否只在某目录或某类文件生效
可选前置步骤
如果怀疑同类经验已反复出现、或者想了解当前分诊模式的全貌，先运行统计脚本查看历史模式：
python 06-工具脚本/check_triage_patterns.py
脚本会输出：各分诊规则的命中次数分布、推荐层级分布、沉淀决策比例、以及满足阈值（默认 ≥3 次）的重复经验模式。
如果脚本发现当前分诊对象与历史重复模式匹配，应在输出中增加 【历史信号】 字段（见输出格式）。
可选参数：
--min-repeat N：调整重复阈值（默认 3）--json：输出结构化 JSON，供其他工具消费--history <path>：指定历史文件路径
分诊规则
按以下顺序判断，不要跳步：
-
是否值得长期沉淀。
不值得时，明确“不升级”，保留在当前对话、本轮过程文档或现有位置。
-
是否属于稳定业务主定义。
如果本质上是稳定业务规则、页面规则、字段规则、流程主定义或历史决策原因，不进入协作规则层，直接建议拆回正式主定义层。
-
是否每个会话都应该知道。
如果所有相关任务都该默认知道，进顶层默认层。当前仓库优先 AGENTS.md；只有 AGENTS.md 没有合适承载位时才考虑 CLAUDE.md。
-
是否只对某目录或某类文件生效。
如果只对局部目录、局部资产类型或局部文件生效，进路径作用域规则层。当前仓库默认写入对应目录 README.md。
-
是否多步流程、专题检查、分支决策。
如果对象本质上是 workflow，进 skill 层，当前仓库落到 .codex/skills/<skill-name>/SKILL.md。
-
是否需要真实执行或查询。
如果必须运行命令、读取仓库现状、调用脚本、查询数据或执行检查，进 CLI / MCP / scripts / checker 层，不要只写成提醒。
-
是否必须每次执行、不能靠模型自觉。
如果零例外、每次都必须发生，且最适合由事件触发自动执行，进 hook 候选层。当前仓库优先参考仓库级 .codex/config.toml 与 .codex/hooks/。
如果它更适合执行前阻断，优先考虑 PreToolUse / PermissionRequest 类型 hook。
如果它更适合执行后反馈或轻量背压，优先考虑 PostToolUse 类型 hook。
-
是否已从专题经验变成通用约束。
如果当前在 skill 中，但已反复复用且所有相关任务都应遵守，建议从 skill 上移到顶层默认层。当前仓库优先上移到 AGENTS.md。
输出格式
必须使用以下格式输出：
【分诊对象】
一句话说明当前要分诊的对象。
【是否沉淀】
写“沉淀”或“不沉淀”。
【命中规则】
写明命中上面第几条规则；若未命中，明确写“未命中规则 2-8，当前不沉淀”。
【推荐层级】
写明推荐进入哪一层：顶层默认层、path-scoped rules、skill、hook、script/CLI/MCP/checker、正式主定义层、或“暂不沉淀”。
【推荐位置】
给出当前仓库中的具体落点或落点类型。
【建议动作】
给出下一步动作。只写当前需要做的最小动作。
【上移提醒】
如果适用，说明是否应从 skill 上移到顶层默认层；当前仓库默认优先上移到 AGENTS.md。如果不适用，明确写“当前不涉及上移”。
【历史信号】（可选，仅当运行了 check_triage_patterns.py 或已知同类经验反复出现时输出）
写明历史中同类经验的累计出现次数和趋势判断。格式：
同类经验已出现 N 次 + 建议（例如：建议从 03-工作台 上移到 AGENTS.md、建议沉淀为专项 skill、当前无需额外动作）
如果没有运行统计脚本且不确定历史情况，明确写“未检查历史模式”；如果已检查但无重复，写“历史中未发现同类模式”。
红线
- 不要把只对局部目录生效的规则上移到顶层默认层
- 不要把需要真实执行的动作写成只靠记忆的说明
- 不要把稳定业务主定义继续留在
03-工作台
- 不要把“暂不沉淀”的对象硬塞进某个层级
- 不要把
AGENTS.md 和 CLAUDE.md 当成并列主承载位；当前仓库以 AGENTS.md 为主
