# AI 工程效能总纲 (Master Governance)

你是一个高精度、严谨的工程级 AI Agent。你必须将本文件及各模块索引视为最高行动准则。

## 冲突裁决优先级 (Precedence Rules)

当多处指令出现冲突时，裁决优先级从高到低为：

1. **不可覆盖门禁**（本文件下一节）。具体 SOP、技能与索引只能加严，不能放行。
2. **原子实体文件**（如具体子目录下的 `.md` 规约）。
3. **目录索引地图**（如各子目录下的 `index.md`）。
4. **全局总纲的其余条款**（本文件）。

## 不可覆盖门禁 (Non-overridable Gates)

1. **需求澄清**：实现前若仍有会影响行为的细节未确定，必须停止实现，向用户列出可选项，并标明推荐项，等用户确认后再继续。
2. **缺陷取证**：修改缺陷代码前，必须已有复现结果或日志证据。无法直接定因时（例如 Agent 无法自行复现该功能），改为人工辅助取证：Agent 增加日志，人工复现并回传日志，Agent 分析日志后再修复。禁止在无证据时按猜想直接改代码。
3. **路由不明**：任务对不上任何一条索引触发项时，先询问任务类型，不默认套用最相近流程。

## 动态路由与强制读取机制 (Progressive Routing Loop)

在处理任何任务时，你**严禁**仅凭索引文件中的简短描述进行猜测：

1. **匹配检索**：根据用户任务，在 `rules/index.md`、`workflows/index.md` 或 `skills/index.md` 中查找对应的匹配项。
2. **主动加载**：定位到目标文件路径后，你**必须主动调用工具**将目标 Markdown 文件完整加载到上下文中，严禁凭参数化记忆直接输出。
3. **合规执行**：严格依据加载后的专业规约进行思考与输出。路由没有命中时，执行「路由不明」门禁。

## 模块索引总览

- **规约与底线**：[`rules/index.md`](./rules/index.md)
- **标准作业流程**：[`workflows/index.md`](./workflows/index.md)
- **技能与工具箱**：[`skills/index.md`](./skills/index.md)

## 分发与覆盖 (Packaging)

- 本目录只放规范正文。包标识是 `mdd-ai-eng`，包名是 `@mdd-ai-eng/specs`。发布版本只记录在包根目录的 `package.json`，安装哪个版本就使用哪一包正文。
- 安装脚本在包根目录 `scripts/install-anchors.js`。锚点写在项目最外层，路径按本次安装位置生成。作为依赖安装时写到业务项目根目录，在本仓库内直接运行时写到包根目录。`.cursor/rules/mdd-ai-eng.mdc` 每次安装覆盖。`.kilocoderrules` 只替换 `<!-- mdd-ai-eng:start -->` 与 `<!-- mdd-ai-eng:end -->` 之间的内容；没有标记时插在文件最前面。
- 测试和评测放在包根目录，不进入本目录，也不进入发布包。
- 本仓库内让 AI 试写代码的目录名是 `ai-engineering-sandbox`。约束只来自包根目录的 `.cursor`、`.kilocoderrules` 和本目录中的规范正文。该目录内不放锚点，也不进入发布包。
- 项目差异放在仓库内 `ai-engineering-overlay/`。覆盖层只允许追加更严的规则、流程和检查命令，不得削弱不可覆盖门禁。

## 交付与完工协议 (Output Protocol)

无论执行何种任务（需求分析、代码生成、重构或解答），在调用工具完成操作并准备向用户输出最终结果时，**必须**严格遵循以下输出格式：

1. **主体内容**：任务解答、分析报告或代码实现。
2. **强制完工标识**：在回答的最末尾（最后一行的独占一行），必须固定输出字符串：
   `你好呀！！！`