data-governance-layer-triage

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>：指定历史文件路径

分诊规则

按以下顺序判断，不要跳步：

1. 是否值得长期沉淀。 不值得时，明确“不升级”，保留在当前对话、本轮过程文档或现有位置。

2. 是否属于稳定业务主定义。 如果本质上是稳定业务规则、页面规则、字段规则、流程主定义或历史决策原因，不进入协作规则层，直接建议拆回正式主定义层。

3. 是否每个会话都应该知道。 如果所有相关任务都该默认知道，进顶层默认层。当前仓库优先 AGENTS.md；只有 AGENTS.md 没有合适承载位时才考虑 CLAUDE.md。

4. 是否只对某目录或某类文件生效。 如果只对局部目录、局部资产类型或局部文件生效，进路径作用域规则层。当前仓库默认写入对应目录 README.md。

5. 是否多步流程、专题检查、分支决策。 如果对象本质上是 workflow，进 skill 层，当前仓库落到 .codex/skills/<skill-name>/SKILL.md。

6. 是否需要真实执行或查询。 如果必须运行命令、读取仓库现状、调用脚本、查询数据或执行检查，进 CLI / MCP / scripts / checker 层，不要只写成提醒。

7. 是否必须每次执行、不能靠模型自觉。 如果零例外、每次都必须发生，且最适合由事件触发自动执行，进 hook 候选层。当前仓库优先参考仓库级 .codex/config.toml 与 .codex/hooks/。 如果它更适合执行前阻断，优先考虑 PreToolUse / PermissionRequest 类型 hook。 如果它更适合执行后反馈或轻量背压，优先考虑 PostToolUse 类型 hook。

8. 是否已从专题经验变成通用约束。 如果当前在 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 为主