# 通用 AI Coding 生产控制知识入口

本 catalog 用于按需加载 `common/` 下的通用 AI 编程生产控制资料。项目事实、PRD、架构约束、测试矩阵和当前 `task.json` 始终优先于本目录内容。

## 使用规则

1. 先读本 catalog，不要默认把完整长文档放进每轮上下文。
2. 当前任务涉及 AI 生成代码治理、任务拆分、架构边界、接口契约、Review Gate、Release Gate、安全/隐私/依赖风险或生产交付控制时，再读取对应条目。
3. 外部知识只能补充 checklist 和风险识别，不能覆盖项目 truth source。
4. 采纳本目录内容后，应在 trace 或最终报告的 `knowledge_references` 中记录引用。

## 条目索引

| 条目 | 路径 | 适用阶段 | 读取触发 |
| --- | --- | --- | --- |
| AI Coding Production Control Framework | `common/AI_Coding_Production_Control_Framework_AI写完的代码如何不失控.md` | analysis / plan / implement / review / release | 需要控制 AI 代码失控风险、补齐架构/模式/实现三层约束、设计高风险人工 Review、定义 Release Gate 或 PR/Review 模板 |

## 可吸收检查项

| 主题 | 当前项目落点 |
| --- | --- |
| 三层控制模型 | `docs/architecture/constraints.md`、`task.json.architecture_constraints`、Stage 1 Review |
| 任务边界 | `owned_paths`、`context_files`、`forbidden_implementations` |
| 契约与验收 | `docs/testing/TRACEABILITY_MATRIX.md`、`qa_contract`、`test_command` |
| 证据留存 | `traces/`、`progress.txt`、`docs/testing/EVIDENCE_PROTOCOL.md` |
| 高风险 Review | `security-reviewer`、Stage 2 Review、任务级风险字段或人工确认项 |
| Release Gate | `release` 任务、P0/P1 回归、跨故事整链路和 fresh evidence |

## 不要直接吸收的内容

- 不把全文搬进 `AGENTS.md`。
- 不用通用 React/Python 示例覆盖具体项目技术栈。
- 不把一次性经验直接升级为 proven 级规则。
- 不把外部文档里的模板字段当成当前项目已确认事实。
