@pzy560117/codex-harness 0.1.3 → 0.1.5

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/external-knowledge/common/catalog.md

@@ -1,34 +1,34 @@
-# 通用 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 级规则。
-- 不把外部文档里的模板字段当成当前项目已确认事实。
+# 通用 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 级规则。
+- 不把外部文档里的模板字段当成当前项目已确认事实。