@pzy560117/codex-harness 0.1.3 → 0.1.4

package/package-source/docs/codex-harness-engineering/templates/product/difficulty-research.md

@@ -1,47 +1,47 @@
-# Difficulty Research 模板
-
-> 目标: 在编码前提前研究所有实现难点、风险点和不确定点。不能把关键研究推迟到实现阶段。
-
-## 1. 难点总览
-
-| Difficulty ID | 难点 / 不确定点 | 来源需求 | 影响页面 / 接口 | 风险等级 | 是否阻塞 | 负责人 | 状态 |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| DR-001 | | FR-001 | page-001 / API | High / Medium / Low | Yes / No | | Open |
-
-## 2. 研究记录
-
-### DR-001: [难点名称]
-
-- 关联需求:
-- 关联界面:
-- 问题描述:
-- 为什么现在必须研究:
-- 已知约束:
-- 可选方案:
-
-| 方案 | 优点 | 缺点 | 风险 | 验证方式 |
-| --- | --- | --- | --- | --- |
-| A | | | | |
-| B | | | | |
-
-**结论**:
-
-**选择理由**:
-
-**后续任务影响**:
-
-**仍需确认**:
-
-## 3. 前置验证
-
-| 验证项 | 方法 | 结果 | 证据路径 | 是否通过 |
-| --- | --- | --- | --- | --- |
-| 可行性验证 | spike / 文档调研 / 原型 / mock | | | Pending |
-
-## 4. 通过标准
-
-- [ ] P0/P1 需求相关难点已列出。
-- [ ] 高风险难点已有研究结论或明确 BLOCKED。
-- [ ] 方案选择记录了备选方案和拒绝理由。
-- [ ] 研究结论已同步到 PRD、Design Brief、DEV-PLAN 或 Contract。
-- [ ] 后续实现任务不再需要重新判断核心方案。
+# Difficulty Research 模板
+
+> 目标: 在编码前提前研究所有实现难点、风险点和不确定点。不能把关键研究推迟到实现阶段。
+
+## 1. 难点总览
+
+| Difficulty ID | 难点 / 不确定点 | 来源需求 | 影响页面 / 接口 | 风险等级 | 是否阻塞 | 负责人 | 状态 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| DR-001 | | FR-001 | page-001 / API | High / Medium / Low | Yes / No | | Open |
+
+## 2. 研究记录
+
+### DR-001: [难点名称]
+
+- 关联需求:
+- 关联界面:
+- 问题描述:
+- 为什么现在必须研究:
+- 已知约束:
+- 可选方案:
+
+| 方案 | 优点 | 缺点 | 风险 | 验证方式 |
+| --- | --- | --- | --- | --- |
+| A | | | | |
+| B | | | | |
+
+**结论**:
+
+**选择理由**:
+
+**后续任务影响**:
+
+**仍需确认**:
+
+## 3. 前置验证
+
+| 验证项 | 方法 | 结果 | 证据路径 | 是否通过 |
+| --- | --- | --- | --- | --- |
+| 可行性验证 | spike / 文档调研 / 原型 / mock | | | Pending |
+
+## 4. 通过标准
+
+- [ ] P0/P1 需求相关难点已列出。
+- [ ] 高风险难点已有研究结论或明确 BLOCKED。
+- [ ] 方案选择记录了备选方案和拒绝理由。
+- [ ] 研究结论已同步到 PRD、Design Brief、DEV-PLAN 或 Contract。
+- [ ] 后续实现任务不再需要重新判断核心方案。

package/package-source/docs/codex-harness-engineering/templates/product/page-inventory.md

@@ -1,21 +1,21 @@
-# Page Inventory 模板
-
-> 目标: 明确本功能涉及的所有页面、视图、弹窗、抽屉和嵌入区，避免设计和实现阶段漏掉状态。
-
-| Page ID | 页面/视图 | 路由/入口 | 类型 | 角色 | 核心目标 | 关键状态 | 依赖接口 | 关联需求 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| page-001 | | | 列表/详情/表单/弹窗/抽屉/嵌入视图 | | | default, empty, loading, error | | FR-001 |
-
-## 状态覆盖检查
-
-| Page ID | default | empty | loading | error | permission_denied | disabled | long_content | mobile |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| page-001 | 是 | 是/否 | 是/否 | 是/否 | 是/否 | 是/否 | 是/否 | 是/否 |
-
-## 使用说明
-
-- 每一行只描述一个页面或一个独立视图。
-- 弹窗、抽屉、嵌入式子视图也应单独列出。
-- `关键状态` 至少列出 `default / empty / loading / error`。
-- 如果某个状态不适用，在状态覆盖检查中写明“否”和原因，不要留空。
-- `Page ID` 必须能被 `state-matrix.yaml`、`screen-states.md`、stories 和 e2e 用例引用。
+# Page Inventory 模板
+
+> 目标: 明确本功能涉及的所有页面、视图、弹窗、抽屉和嵌入区，避免设计和实现阶段漏掉状态。
+
+| Page ID | 页面/视图 | 路由/入口 | 类型 | 角色 | 核心目标 | 关键状态 | 依赖接口 | 关联需求 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| page-001 | | | 列表/详情/表单/弹窗/抽屉/嵌入视图 | | | default, empty, loading, error | | FR-001 |
+
+## 状态覆盖检查
+
+| Page ID | default | empty | loading | error | permission_denied | disabled | long_content | mobile |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| page-001 | 是 | 是/否 | 是/否 | 是/否 | 是/否 | 是/否 | 是/否 | 是/否 |
+
+## 使用说明
+
+- 每一行只描述一个页面或一个独立视图。
+- 弹窗、抽屉、嵌入式子视图也应单独列出。
+- `关键状态` 至少列出 `default / empty / loading / error`。
+- 如果某个状态不适用，在状态覆盖检查中写明“否”和原因，不要留空。
+- `Page ID` 必须能被 `state-matrix.yaml`、`screen-states.md`、stories 和 e2e 用例引用。

package/package-source/docs/codex-harness-engineering/templates/product/prd-lite.md

@@ -1,158 +1,166 @@
-# PRD-Lite 模板
-
-> 目标: 把原始需求收敛成 Codex 可以直接消费的产品真相源。未填完整前，不应进入设计或实现阶段。
-
-## 1. 基本信息
-
-- Feature ID:
-- Feature 名称:
-- 来源: issue / 会议纪要 / 事故复盘 / 业务需求 / 其他
-- 负责人:
-- 相关方:
-- 当前状态: Draft / Review / Approved / Changed
-- 最后更新:
-
-## 2. 背景与问题
-
-- 业务背景:
-- 当前问题:
-- 为什么现在做:
-- 不做的影响:
-- 现有替代方案:
-
-## 3. 目标与非目标
-
-### 目标
-
-| 目标 ID | 目标描述 | 衡量方式 | 优先级 |
-| --- | --- | --- | --- |
-| G-001 | | | P0 |
-
-### 非目标
-
-| 非目标 ID | 本期明确不做 | 原因 | 后续处理 |
-| --- | --- | --- | --- |
-| NG-001 | | | |
-
-## 4. 用户与角色
-
-| 角色 | 使用场景 | 核心诉求 | 权限差异 | 优先级 |
-| --- | --- | --- | --- | --- |
-| | | | | P0 |
-
-## 5. 范围边界
-
-| 范围 | 内容 |
-| --- | --- |
-| In scope | |
-| Out of scope | |
-| 允许变更 | |
-| 禁止变更 | |
-| 依赖前置条件 | |
-
-## 6. 业务流程
-
-### 主流程
-
-```mermaid
-flowchart TD
-  A[开始] --> B[核心步骤]
-  B --> C[完成]
-```
-
-### 异常流程
-
-| 场景 ID | 异常场景 | 触发条件 | 预期行为 | 兜底策略 |
-| --- | --- | --- | --- | --- |
-| E-001 | | | | |
-
-## 7. 页面 / 流程 / 接口影响
-
-| 类型 | 名称 | 影响说明 | 对应真相源 |
-| --- | --- | --- | --- |
-| 页面 | | | `page-inventory.md` |
-| 状态 | | | `state-matrix.yaml` |
-| 接口 | | | `contracts/openapi.yaml` |
-| 权限 | | | 本文权限矩阵 |
-
-## 8. 功能需求
-
-| 需求 ID | 用户故事 / 能力 | 优先级 | 关联页面 | 关联状态 | 验收入口 |
-| --- | --- | --- | --- | --- | --- |
-| FR-001 | As a [角色], I want [能力], so that [价值] | P0 | | | `acceptance-criteria.md` |
-
-## 9. 需求到界面追溯
-
-| 需求 ID | 关联页面 / 视图 | 页面状态 | UI 元素 / 操作 | 依赖字段 | 依赖接口 | 验收标准 | 追溯状态 |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| FR-001 | page-001 | default / empty / loading / error | | | | AC-001 | Pending |
-
-> 完整追溯矩阵维护在 `docs/product/requirement-interface-matrix.md`。所有 P0/P1 需求必须完成映射。
-
-## 10. 前置难点研究
-
-| 难点 ID | 难点 / 不确定点 | 关联需求 | 影响界面 / 接口 | 风险等级 | 研究结论 | 状态 |
-| --- | --- | --- | --- | --- | --- | --- |
-| DR-001 | | FR-001 | page-001 / API | High / Medium / Low | | Open |
-
-> 详细研究记录维护在 `docs/product/difficulty-research.md`。高风险难点未关闭前，不进入实现阶段。
-
-## 11. 业务规则
-
-| 规则 ID | 规则描述 | 触发时机 | 校验逻辑 | 不满足时行为 |
-| --- | --- | --- | --- | --- |
-| BR-001 | | | | |
-
-## 12. 权限矩阵
-
-| 操作 | 角色 A | 角色 B | 角色 C | 备注 |
-| --- | --- | --- | --- | --- |
-| 查看 | 允许 | 只读 | 禁止 | |
-
-## 13. 数据与字段
-
-| 字段 | 中文名 | 类型 | 来源 | 必填 | 取值范围 / 枚举 | 边界规则 |
-| --- | --- | --- | --- | --- | --- | --- |
-| | | | | | | |
-
-## 14. 非功能需求
-
-| 类型 | 要求 | 指标 / 标准 | 优先级 | 验证方式 |
-| --- | --- | --- | --- | --- |
-| 性能 | | | P0 | |
-| 安全 | | | P0 | |
-| 可用性 | | | P1 | |
-| 可访问性 | | | P1 | |
-| 兼容性 | | | P1 | |
-
-## 15. 成功标准
-
-| 指标 ID | 成功标准 | 目标值 | 衡量方式 |
-| --- | --- | --- | --- |
-| SC-001 | | | |
-
-## 16. 风险、假设与待确认
-
-### 风险
-
-| 风险 ID | 风险描述 | 影响 | 概率 | 缓解措施 | 负责人 |
-| --- | --- | --- | --- | --- | --- |
-| R-001 | | 高/中/低 | 高/中/低 | | |
-
-### 假设
-
-| 假设 ID | 假设内容 | 验证方式 | 失效影响 |
-| --- | --- | --- | --- |
-| A-001 | | | |
-
-### 待确认
-
-| 问题 ID | 问题 | 相关方 | 截止日期 | 状态 |
-| --- | --- | --- | --- | --- |
-| Q-001 | | | | 待确认 |
-
-## 17. 变更记录
-
-| 版本 | 日期 | 变更内容 | 影响范围 | 评审人 |
-| --- | --- | --- | --- | --- |
-| v0.1 | | 初稿 | | |
+# PRD-Lite 模板
+
+> 目标: 把原始需求收敛成 Codex 可以直接消费的产品真相源。未填完整前，不应进入设计或实现阶段。
+
+## 1. 基本信息
+
+- Feature ID:
+- Feature 名称:
+- 来源: issue / 会议纪要 / 事故复盘 / 业务需求 / 其他
+- 负责人:
+- 相关方:
+- 当前状态: Draft / Review / Approved / Changed
+- 最后更新:
+
+## 2. 背景与问题
+
+- 业务背景:
+- 当前问题:
+- 为什么现在做:
+- 不做的影响:
+- 现有替代方案:
+
+## 3. 目标与非目标
+
+### 目标
+
+| 目标 ID | 目标描述 | 衡量方式 | 优先级 |
+| --- | --- | --- | --- |
+| G-001 | | | P0 |
+
+### 非目标
+
+| 非目标 ID | 本期明确不做 | 原因 | 后续处理 |
+| --- | --- | --- | --- |
+| NG-001 | | | |
+
+## 4. 用户与角色
+
+| 角色 | 使用场景 | 核心诉求 | 权限差异 | 优先级 |
+| --- | --- | --- | --- | --- |
+| | | | | P0 |
+
+## 5. 范围边界
+
+| 范围 | 内容 |
+| --- | --- |
+| In scope | |
+| Out of scope | |
+| 允许变更 | |
+| 禁止变更 | |
+| 依赖前置条件 | |
+
+## 6. 业务流程
+
+### 主流程
+
+```mermaid
+flowchart TD
+  A[开始] --> B[核心步骤]
+  B --> C[完成]
+```
+
+### 异常流程
+
+| 场景 ID | 异常场景 | 触发条件 | 预期行为 | 兜底策略 |
+| --- | --- | --- | --- | --- |
+| E-001 | | | | |
+
+## 7. 页面 / 流程 / 接口影响
+
+| 类型 | 名称 | 影响说明 | 对应真相源 |
+| --- | --- | --- | --- |
+| 页面 | | | `page-inventory.md` |
+| 状态 | | | `state-matrix.yaml` |
+| 接口 | | | `contracts/openapi.yaml` |
+| 权限 | | | 本文权限矩阵 |
+
+## 8. 功能需求
+
+| 需求 ID | 用户故事 / 能力 | 优先级 | 关联页面 | 关联状态 | 验收入口 |
+| --- | --- | --- | --- | --- | --- |
+| FR-001 | As a [角色], I want [能力], so that [价值] | P0 | | | `acceptance-criteria.md` |
+
+## 9. 需求到界面追溯
+
+| 需求 ID | 关联页面 / 视图 | 页面状态 | UI 元素 / 操作 | 依赖字段 | 依赖接口 | 验收标准 | 追溯状态 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| FR-001 | page-001 | default / empty / loading / error | | | | AC-001 | Pending |
+
+> 完整追溯矩阵维护在 `docs/product/requirement-interface-matrix.md`。所有 P0/P1 需求必须完成映射。
+
+## 10. 前置难点研究
+
+| 难点 ID | 难点 / 不确定点 | 关联需求 | 影响界面 / 接口 | 风险等级 | 研究结论 | 状态 |
+| --- | --- | --- | --- | --- | --- | --- |
+| DR-001 | | FR-001 | page-001 / API | High / Medium / Low | | Open |
+
+> 详细研究记录维护在 `docs/product/difficulty-research.md`。高风险难点未关闭前，不进入实现阶段。
+
+## 11. 业务规则
+
+| 规则 ID | 规则描述 | 触发时机 | 校验逻辑 | 不满足时行为 |
+| --- | --- | --- | --- | --- |
+| BR-001 | | | | |
+
+至少覆盖：
+
+- 状态流转规则
+- 权限拒绝规则
+- 幂等 / 重复提交规则
+- 外部依赖失败或超时后的兜底规则
+- 对金额、库存、次数、唯一性等关键不变量的保护规则
+
+## 12. 权限矩阵
+
+| 操作 | 角色 A | 角色 B | 角色 C | 备注 |
+| --- | --- | --- | --- | --- |
+| 查看 | 允许 | 只读 | 禁止 | |
+
+## 13. 数据与字段
+
+| 字段 | 中文名 | 类型 | 来源 | 必填 | 取值范围 / 枚举 | 边界规则 |
+| --- | --- | --- | --- | --- | --- | --- |
+| | | | | | | |
+
+## 14. 非功能需求
+
+| 类型 | 要求 | 指标 / 标准 | 优先级 | 验证方式 |
+| --- | --- | --- | --- | --- |
+| 性能 | | | P0 | |
+| 安全 | | | P0 | |
+| 可用性 | | | P1 | |
+| 可访问性 | | | P1 | |
+| 兼容性 | | | P1 | |
+
+## 15. 成功标准
+
+| 指标 ID | 成功标准 | 目标值 | 衡量方式 |
+| --- | --- | --- | --- |
+| SC-001 | | | |
+
+## 16. 风险、假设与待确认
+
+### 风险
+
+| 风险 ID | 风险描述 | 影响 | 概率 | 缓解措施 | 负责人 |
+| --- | --- | --- | --- | --- | --- |
+| R-001 | | 高/中/低 | 高/中/低 | | |
+
+### 假设
+
+| 假设 ID | 假设内容 | 验证方式 | 失效影响 |
+| --- | --- | --- | --- |
+| A-001 | | | |
+
+### 待确认
+
+| 问题 ID | 问题 | 相关方 | 截止日期 | 状态 |
+| --- | --- | --- | --- | --- |
+| Q-001 | | | | 待确认 |
+
+## 17. 变更记录
+
+| 版本 | 日期 | 变更内容 | 影响范围 | 评审人 |
+| --- | --- | --- | --- | --- |
+| v0.1 | | 初稿 | | |

package/package-source/docs/codex-harness-engineering/templates/product/requirement-interface-matrix.md

@@ -1,37 +1,37 @@
-# Requirement Interface Matrix 模板
-
-> 目标: 确保需求分析完成后，每一条需求都能追溯到具体界面、界面状态、字段、操作、接口和验收证据。没有映射完成前，不进入设计或实现阶段。
-
-## 1. 需求到界面映射
-
-| Requirement ID | 需求摘要 | 用户角色 | 关联页面 / 视图 | 页面状态 | UI 元素 / 操作 | 关联字段 | 依赖接口 | 验收标准 | 覆盖状态 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| FR-001 | | | page-001 | default / empty / loading / error | | | | AC-001 | Pending |
-
-## 2. 界面到需求反查
-
-| Page ID | 页面 / 视图 | 页面目标 | 覆盖需求 | 未覆盖需求 | 多余功能风险 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- |
-| page-001 | | | FR-001 | | | |
-
-## 3. 状态到需求映射
-
-| Page ID | State | 触发需求 / 业务规则 | 用户可见表现 | 依赖数据 / 接口 | 验收标准 | 设计图 |
-| --- | --- | --- | --- | --- | --- | --- |
-| page-001 | default | FR-001 | | | AC-001 | |
-| page-001 | empty | FR-001 / BR-001 | | | AC-E001 | |
-| page-001 | error | FR-001 / NFR-001 | | | AC-E002 | |
-
-## 4. 缺口清单
-
-| Gap ID | 缺口类型 | 描述 | 影响阶段 | 处理方式 | 负责人 | 截止 |
-| --- | --- | --- | --- | --- | --- | --- |
-| GAP-001 | 需求未映射界面 / 界面无需求 / 状态缺失 / 接口缺失 | | Spec / Design / Code | 补需求 / 补设计 / 删除多余功能 / 阻塞 | | |
-
-## 5. 通过标准
-
-- [ ] 每个 P0/P1 需求至少映射到一个页面、状态或接口。
-- [ ] 每个页面、弹窗、抽屉、嵌入视图都有需求来源。
-- [ ] 每个 required state 都有触发条件、界面表现和验收标准。
-- [ ] 没有“界面有功能但需求没有”的多余实现。
-- [ ] 所有缺口已关闭，或明确标记 BLOCKED。
+# Requirement Interface Matrix 模板
+
+> 目标: 确保需求分析完成后，每一条需求都能追溯到具体界面、界面状态、字段、操作、接口和验收证据。没有映射完成前，不进入设计或实现阶段。
+
+## 1. 需求到界面映射
+
+| Requirement ID | 需求摘要 | 用户角色 | 关联页面 / 视图 | 页面状态 | UI 元素 / 操作 | 关联字段 | 依赖接口 | 验收标准 | 覆盖状态 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| FR-001 | | | page-001 | default / empty / loading / error | | | | AC-001 | Pending |
+
+## 2. 界面到需求反查
+
+| Page ID | 页面 / 视图 | 页面目标 | 覆盖需求 | 未覆盖需求 | 多余功能风险 | 备注 |
+| --- | --- | --- | --- | --- | --- | --- |
+| page-001 | | | FR-001 | | | |
+
+## 3. 状态到需求映射
+
+| Page ID | State | 触发需求 / 业务规则 | 用户可见表现 | 依赖数据 / 接口 | 验收标准 | 设计图 |
+| --- | --- | --- | --- | --- | --- | --- |
+| page-001 | default | FR-001 | | | AC-001 | |
+| page-001 | empty | FR-001 / BR-001 | | | AC-E001 | |
+| page-001 | error | FR-001 / NFR-001 | | | AC-E002 | |
+
+## 4. 缺口清单
+
+| Gap ID | 缺口类型 | 描述 | 影响阶段 | 处理方式 | 负责人 | 截止 |
+| --- | --- | --- | --- | --- | --- | --- |
+| GAP-001 | 需求未映射界面 / 界面无需求 / 状态缺失 / 接口缺失 | | Spec / Design / Code | 补需求 / 补设计 / 删除多余功能 / 阻塞 | | |
+
+## 5. 通过标准
+
+- [ ] 每个 P0/P1 需求至少映射到一个页面、状态或接口。
+- [ ] 每个页面、弹窗、抽屉、嵌入视图都有需求来源。
+- [ ] 每个 required state 都有触发条件、界面表现和验收标准。
+- [ ] 没有“界面有功能但需求没有”的多余实现。
+- [ ] 所有缺口已关闭，或明确标记 BLOCKED。