@pzy560117/codex-harness 0.1.3 → 0.1.5

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/task.json

@@ -1,54 +1,54 @@
-{
-  "runtime": {
-    "driver": "powershell -NoProfile -ExecutionPolicy Bypass -File .\\tools\\harness\\tools/harness/codex-loop.ps1",
-    "run_profile": ".codex\\task-run-profile.json"
-  },
-  "tasks": [
-    {
-      "id": "DEMO-TICKET-FILTER-001",
-      "description": "对齐工单筛选 demo 的真相源、组件样例与 generated client 样例",
-      "task_kind": "feature_impl",
-      "gate_profile": "contract_required",
-      "required_truth_sources": [
-        "product",
-        "design",
-        "plan",
-        "contract"
-      ],
-      "phase": "P2",
-      "priority": 1,
-      "dependencies": [],
-      "passes": false,
-      "context_files": [
-        "docs\\product\\prd-lite.md",
-        "docs\\product\\state-matrix.yaml",
-        "docs\\product\\requirement-interface-matrix.md",
-        "docs\\product\\difficulty-research.md",
-        "docs\\design\\design-brief.md",
-        "docs\\design\\ai-image-brief.md",
-        "docs\\design\\ui-image-review.md",
-        "docs\\design\\image-to-frontend-spec.md",
-        "docs\\design\\frontend-architecture.md",
-        "docs\\design\\component-map.md",
-        "docs\\design\\screen-states.md",
-        "plans\\features\\ticket-filter.dev-plan.md",
-        "contracts\\openapi.yaml",
-        "packages\\ui\\TicketFilterBar.tsx",
-        "stories\\TicketFilterBar.stories.tsx",
-        "packages\\api-client\\generated\\ticket-api.ts"
-      ],
-      "steps": [
-        "阅读 product、需求-界面追溯、难点研究、design、frontend architecture、AI 生图评审、图转前端规格、dev-plan 和 contract 真相源",
-        "确认组件、story、generated client 与真相源一致",
-        "如有需要补齐 demo 资产",
-        "运行 tools/harness/verify.ps1 验证 demo 闭环"
-      ],
-      "test_command": "powershell -NoProfile -ExecutionPolicy Bypass -File .\\tools\\harness\\tools/harness/verify.ps1",
-      "acceptance": [
-        "demo 目录同时具备 product、design、frontend architecture、dev-plan、contract、component、story、generated client",
-        "tools/harness/verify.ps1 通过",
-        "trace 样例能表达 Stage 1、测试和 Stage 2 的结果"
-      ]
-    }
-  ]
-}
+{
+  "runtime": {
+    "driver": "powershell -NoProfile -ExecutionPolicy Bypass -File .\\tools\\harness\\tools/harness/codex-loop.ps1",
+    "run_profile": ".codex\\task-run-profile.json"
+  },
+  "tasks": [
+    {
+      "id": "DEMO-TICKET-FILTER-001",
+      "description": "对齐工单筛选 demo 的真相源、组件样例与 generated client 样例",
+      "task_kind": "feature_impl",
+      "gate_profile": "contract_required",
+      "required_truth_sources": [
+        "product",
+        "design",
+        "plan",
+        "contract"
+      ],
+      "phase": "P2",
+      "priority": 1,
+      "dependencies": [],
+      "passes": false,
+      "context_files": [
+        "docs\\product\\prd-lite.md",
+        "docs\\product\\state-matrix.yaml",
+        "docs\\product\\requirement-interface-matrix.md",
+        "docs\\product\\difficulty-research.md",
+        "docs\\design\\design-brief.md",
+        "docs\\design\\ai-image-brief.md",
+        "docs\\design\\ui-image-review.md",
+        "docs\\design\\image-to-frontend-spec.md",
+        "docs\\design\\frontend-architecture.md",
+        "docs\\design\\component-map.md",
+        "docs\\design\\screen-states.md",
+        "plans\\features\\ticket-filter.dev-plan.md",
+        "contracts\\openapi.yaml",
+        "packages\\ui\\TicketFilterBar.tsx",
+        "stories\\TicketFilterBar.stories.tsx",
+        "packages\\api-client\\generated\\ticket-api.ts"
+      ],
+      "steps": [
+        "阅读 product、需求-界面追溯、难点研究、design、frontend architecture、AI 生图评审、图转前端规格、dev-plan 和 contract 真相源",
+        "确认组件、story、generated client 与真相源一致",
+        "如有需要补齐 demo 资产",
+        "运行 tools/harness/verify.ps1 验证 demo 闭环"
+      ],
+      "test_command": "powershell -NoProfile -ExecutionPolicy Bypass -File .\\tools\\harness\\tools/harness/verify.ps1",
+      "acceptance": [
+        "demo 目录同时具备 product、design、frontend architecture、dev-plan、contract、component、story、generated client",
+        "tools/harness/verify.ps1 通过",
+        "trace 样例能表达 Stage 1、测试和 Stage 2 的结果"
+      ]
+    }
+  ]
+}

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/examples/ticket-filter-demo/verify.ps1

@@ -1,42 +1,42 @@
-Set-StrictMode -Version Latest
-$ErrorActionPreference = "Stop"
-
-$root = Split-Path -Parent $MyInvocation.MyCommand.Path
-
-$requiredPaths = @(
-  "docs/product/prd-lite.md",
-  "docs/product/state-matrix.yaml",
-  "docs/product/requirement-interface-matrix.md",
-  "docs/product/difficulty-research.md",
-  "docs/design/design-brief.md",
-  "docs/design/ai-image-brief.md",
-  "docs/design/ui-image-review.md",
-  "docs/design/image-to-frontend-spec.md",
-  "docs/design/frontend-architecture.md",
-  "docs/design/component-map.md",
-  "docs/design/screen-states.md",
-  "plans/features/ticket-filter.dev-plan.md",
-  "contracts/openapi.yaml",
-  "contracts/orval.config.ts",
-  "packages/ui/TicketFilterBar.tsx",
-  "stories/TicketFilterBar.stories.tsx",
-  "packages/api-client/http-client.ts",
-  "packages/api-client/generated/ticket-api.ts",
-  "packages/api-client/generated/model/Ticket.ts"
-)
-
-$missing = @()
-foreach ($relativePath in $requiredPaths) {
-  $fullPath = Join-Path $root $relativePath
-  if (-not (Test-Path -LiteralPath $fullPath)) {
-    $missing += $relativePath
-  }
-}
-
-if ($missing.Count -gt 0) {
-  Write-Output "Missing required demo assets:"
-  $missing | ForEach-Object { Write-Output "- $_" }
-  exit 1
-}
-
-Write-Output "Ticket filter demo verify passed."
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$root = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+$requiredPaths = @(
+  "docs/product/prd-lite.md",
+  "docs/product/state-matrix.yaml",
+  "docs/product/requirement-interface-matrix.md",
+  "docs/product/difficulty-research.md",
+  "docs/design/design-brief.md",
+  "docs/design/ai-image-brief.md",
+  "docs/design/ui-image-review.md",
+  "docs/design/image-to-frontend-spec.md",
+  "docs/design/frontend-architecture.md",
+  "docs/design/component-map.md",
+  "docs/design/screen-states.md",
+  "plans/features/ticket-filter.dev-plan.md",
+  "contracts/openapi.yaml",
+  "contracts/orval.config.ts",
+  "packages/ui/TicketFilterBar.tsx",
+  "stories/TicketFilterBar.stories.tsx",
+  "packages/api-client/http-client.ts",
+  "packages/api-client/generated/ticket-api.ts",
+  "packages/api-client/generated/model/Ticket.ts"
+)
+
+$missing = @()
+foreach ($relativePath in $requiredPaths) {
+  $fullPath = Join-Path $root $relativePath
+  if (-not (Test-Path -LiteralPath $fullPath)) {
+    $missing += $relativePath
+  }
+}
+
+if ($missing.Count -gt 0) {
+  Write-Output "Missing required demo assets:"
+  $missing | ForEach-Object { Write-Output "- $_" }
+  exit 1
+}
+
+Write-Output "Ticket filter demo verify passed."

package/package-source/docs/codex-harness-engineering/templates/package-assets/docs/codex-harness-engineering/global-rules-and-bootstrap.md

@@ -16,15 +16,15 @@
 | -------- | ---------------------------- | -------------------------------------------------------- | -------------------------------------- |
 | 全局层   | `~/.codex/AGENTS.md`       | 跨项目稳定习惯、危险命令策略、默认输出风格、工具查找规则 | 某个项目的业务术语、目录结构、接口规则 |
 | 项目层   | `<repo>/AGENTS.md`         | 当前仓库的任务规则、测试要求、目录约束、提交要求         | 只在某个子目录成立的细节               |
-| 深文档层 | `<repo>/docs/harness/*.md` | 详细架构、回归规则、trace 格式、CI 策略                  | 高频入口规则                           |
-| 导航层   | `<repo>/docs/ai/repo-map.md` 或同类代码地图 | 关键目录、模块职责、入口文件、禁改区和验证命令 | 逐函数源码解释、无法维护的临时路径 |
+| 深文档层 | `<repo>/docs/harness/*.md` | 详细架构、回归规则、trace 格式、CI 策略                  | 高频入口规则                           |
+| 导航层   | `<repo>/docs/ai/repo-map.md` 或同类代码地图 | 关键目录、模块职责、入口文件、禁改区和验证命令 | 逐函数源码解释、无法维护的临时路径 |
 
 判断标准很简单：
 
 - **换项目后仍然成立**，放全局层。
-- **只在当前仓库成立**，放项目层。
-- **用于帮助 Agent 找代码和理解模块边界**，放导航层。
-- **太长，不适合每次都塞进上下文**，放深文档层。
+- **只在当前仓库成立**，放项目层。
+- **用于帮助 Agent 找代码和理解模块边界**，放导航层。
+- **太长，不适合每次都塞进上下文**，放深文档层。
 
 ## 2. 全局规则怎么写
 
@@ -36,7 +36,7 @@
 2. 工具查找策略，例如先 `Get-Command`，再用绝对路径。
 3. 危险命令策略，例如禁止 `git reset --hard`、禁止在未确认时删文件。
 4. 验证原则，例如“没有 fresh verification evidence 不宣布完成”。
-5. dirty workspace 处理原则。
+5. dirty workspace 处理原则。
 6. 跨项目通用的环境约束，例如 Windows、PowerShell、PATH、代理设置。
 
 不推荐包含：
@@ -61,7 +61,7 @@
 
 - 工具查找策略
 - Windows / PowerShell 通用规则
-- 危险命令和 dirty workspace 原则
+- 危险命令和 dirty workspace 原则
 - 验证优先原则
 - 全局输出语言和通用协作风格
 
@@ -95,17 +95,17 @@
 
 ## 3. 项目规则怎么写
 
-项目 `AGENTS.md` 负责把 Codex 绑定到当前仓库的真实执行方式。
+项目 `AGENTS.md` 负责把 Codex 绑定到当前仓库的真实执行方式。
 
 最少应包含：
 
-- 任务入口文件，例如 `task.json`。
-- driver 命令，例如 `powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/codex-loop.ps1`。
-- 实现前 testing truth source 要求，例如验收示例、追溯矩阵、验证矩阵。
-- 代码地图入口，例如 `docs/ai/repo-map.md`。
-- 测试要求。
-- 阻塞格式。
-- 提交要求。
+- 任务入口文件，例如 `task.json`。
+- driver 命令，例如 `powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/codex-loop.ps1`。
+- 实现前 testing truth source 要求，例如验收示例、追溯矩阵、验证矩阵。
+- 代码地图入口，例如 `docs/ai/repo-map.md`。
+- 测试要求。
+- 阻塞格式。
+- 提交要求。
 - 深文档索引。
 
 可复制模板：
@@ -128,16 +128,16 @@ git init
 
 ### Step 2: 复制最小组合
 
-至少复制以下文件到项目根目录：
-
-```text
-AGENTS.md
-task.json
-tools/harness/codex-loop.ps1
-tools/harness/doctor.ps1
-tools/harness/verify.ps1
-progress.txt
-```
+至少复制以下文件到项目根目录：
+
+```text
+AGENTS.md
+task.json
+tools/harness/codex-loop.ps1
+tools/harness/doctor.ps1
+tools/harness/verify.ps1
+progress.txt
+```
 
 并额外复制默认运行策略文件：
 
@@ -145,134 +145,134 @@ progress.txt
 .codex/task-run-profile.json
 ```
 
-如果这是新项目第一次接入，建议额外复制：
+如果这是新项目第一次接入，建议额外复制：
 
 ```text
 tools/harness/templates/smoke-task.json
 ```
 
-同时复制以下文档到 `docs/harness/`：
-
-```text
-harness-architecture.md
-new-project-usage.md
-regression-rules.md
-spec-to-ui-to-code-workflow.md
-task-session-strategy.md
-trace-format.md
-```
-
-并复制或初始化以下 `docs/testing/` 真相源：
-
-```text
-ACCEPTANCE_CRITERIA.md
-ACCEPTANCE_EXAMPLES.md
-TRACEABILITY_MATRIX.md
-TEST_STRATEGY.md
-TEST_DATA_MATRIX.md
-RISK_BASED_TEST_PLAN.md
-REGRESSION_PLAN.md
-EVIDENCE_PROTOCOL.md
-test-matrix.md
-verify-matrix.md
-failure-triage.md
-test-data-plan.md
-e2e-plan.md
-```
-
-其中：
-
-- `failure-triage.md` 应作为失败一级分类和 owner 二级归因入口，至少区分测试代码问题、产品 Bug、需求变更、环境/数据问题和 Flaky。
-- `e2e-plan.md` 不应对所有任务一刀切；它主要用于涉及用户可见行为、路由、表单、权限、状态流转或关键业务闭环的高风险任务。
-
-建议同时初始化代码地图，作为大型项目的检索入口：
+同时复制以下文档到 `docs/harness/`：
 
 ```text
-docs/ai/repo-map.md
-```
-
-如果使用本包模板，可从 `templates/context/repo-map.md` 复制后按项目事实裁剪。根 `AGENTS.md` 只需要索引它，不要把整张代码地图复制进入口文件。
-
-进入实现前，优先从 `docs/ai/repo-map.md` 或等价 codemap 进入代码结构，再补局部文件阅读；不要把大型仓库的首次理解建立在全仓盲扫上。
-
-通过 `tools/install/install-agent.ps1` 或 `tools/install/bootstrap-codex-harness.ps1` 安装时，模板会自动初始化：
-
-```text
-docs/ai/repo-map.md
-docs/ai/architecture-brief.md
-```
-
-安装后第一件事不是直接跑业务任务，而是把这两个文件从模板内容裁剪为目标项目事实。
-
-### Step 3: 配置项目 `.codex/config.toml`
+harness-architecture.md
+new-project-usage.md
+regression-rules.md
+spec-to-ui-to-code-workflow.md
+task-session-strategy.md
+trace-format.md
+```
+
+并复制或初始化以下 `docs/testing/` 真相源：
+
+```text
+ACCEPTANCE_CRITERIA.md
+ACCEPTANCE_EXAMPLES.md
+TRACEABILITY_MATRIX.md
+TEST_STRATEGY.md
+TEST_DATA_MATRIX.md
+RISK_BASED_TEST_PLAN.md
+REGRESSION_PLAN.md
+EVIDENCE_PROTOCOL.md
+test-matrix.md
+verify-matrix.md
+failure-triage.md
+test-data-plan.md
+e2e-plan.md
+```
+
+其中：
+
+- `failure-triage.md` 应作为失败一级分类和 owner 二级归因入口，至少区分测试代码问题、产品 Bug、需求变更、环境/数据问题和 Flaky。
+- `e2e-plan.md` 不应对所有任务一刀切；它主要用于涉及用户可见行为、路由、表单、权限、状态流转或关键业务闭环的高风险任务。
+
+建议同时初始化代码地图，作为大型项目的检索入口：
+
+```text
+docs/ai/repo-map.md
+```
+
+如果使用本包模板，可从 `templates/context/repo-map.md` 复制后按项目事实裁剪。根 `AGENTS.md` 只需要索引它，不要把整张代码地图复制进入口文件。
+
+进入实现前，优先从 `docs/ai/repo-map.md` 或等价 codemap 进入代码结构，再补局部文件阅读；不要把大型仓库的首次理解建立在全仓盲扫上。
+
+通过 `tools/install/install-agent.ps1` 或 `tools/install/bootstrap-codex-harness.ps1` 安装时，模板会自动初始化：
+
+```text
+docs/ai/repo-map.md
+docs/ai/architecture-brief.md
+```
+
+安装后第一件事不是直接跑业务任务，而是把这两个文件从模板内容裁剪为目标项目事实。
+
+### Step 3: 配置项目 `.codex/config.toml`
 
 按需从模板复制：
 
 - `templates/config/codex-config.toml`
 - `templates/config/mcp-config.toml`
 
-项目配置只放项目特有内容。能在全局复用的项放到 `~/.codex/config.toml`。
-
-如果目标项目准备在 Codex app 中使用 `/goal` 长时间推进，建议保留模板中的 `features.goals = true`。这只是打开 Goal mode 入口，不会替代 Harness 的 `task.json + codex-loop.ps1 + stop hook` 主链。
+项目配置只放项目特有内容。能在全局复用的项放到 `~/.codex/config.toml`。
+
+如果目标项目准备在 Codex app 中使用 `/goal` 长时间推进，建议保留模板中的 `features.goals = true`。这只是打开 Goal mode 入口，不会替代 Harness 的 `task.json + codex-loop.ps1 + stop hook` 主链。
 
 ### Step 4: 初始化任务
 
-编辑 `task.json`：
+编辑 `task.json`：
 
 - 写入任务 id。
-- 写入依赖。
-- 写入 `test_command`。
-- 写入验收标准。
-- 为实现任务写入 `requirement_ids`、affected tests 和 owned paths。
-- 按需为单任务补 `context_files` 和 `execution` 覆盖策略。
-
-如果只是验证接入链路，不要直接写业务任务。先使用 `templates/runtime/tools/harness/templates/smoke-task.json` 做一轮 smoke test，确认 driver、trace、progress 和自动提交都正常，再切回真实 `task.json`。
-
-如果目标是正式业务任务，不要在 testing truth source 还缺失时就急着生成真实任务队列。至少先补齐：
-
-- `ACCEPTANCE_CRITERIA.md`
-- `ACCEPTANCE_EXAMPLES.md`
-- `TRACEABILITY_MATRIX.md`
-- `TEST_DATA_MATRIX.md`
-- `test-matrix.md`
-- `verify-matrix.md`
-
-如果目标仓库是刚 `git init` 的 brand new 仓库，bootstrap 和任务初始化完成后，先做一次基线提交，再启动 driver：
+- 写入依赖。
+- 写入 `test_command`。
+- 写入验收标准。
+- 为实现任务写入 `requirement_ids`、affected tests 和 owned paths。
+- 按需为单任务补 `context_files` 和 `execution` 覆盖策略。
+
+如果只是验证接入链路，不要直接写业务任务。先使用 `templates/runtime/tools/harness/templates/smoke-task.json` 做一轮 smoke test，确认 driver、trace、progress 和自动提交都正常，再切回真实 `task.json`。
+
+如果目标是正式业务任务，不要在 testing truth source 还缺失时就急着生成真实任务队列。至少先补齐：
+
+- `ACCEPTANCE_CRITERIA.md`
+- `ACCEPTANCE_EXAMPLES.md`
+- `TRACEABILITY_MATRIX.md`
+- `TEST_DATA_MATRIX.md`
+- `test-matrix.md`
+- `verify-matrix.md`
+
+如果目标仓库是刚 `git init` 的 brand new 仓库，bootstrap 和任务初始化完成后，先做一次基线提交，再启动 driver：
 
 ```powershell
 git add --all
 git commit -m "chore: bootstrap codex harness baseline"
 ```
 
-这样可以让 clean workspace 检查针对“真正的任务改动”生效，而不是把 bootstrap 入口文件本身当成脏工作区。
+这样可以让 clean workspace 检查针对“真正的任务改动”生效，而不是把 bootstrap 入口文件本身当成脏工作区。
 
 ### Step 5: 跑环境检查和验证
 
-```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/doctor.ps1
-powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/verify.ps1
-```
-
-如果需要先做环境诊断，再额外运行模板里的：
-
-```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -File .\docs\codex-harness-engineering\templates\config\tools/install/env-check.ps1
-```
-
-### Step 6: 首次运行 driver
-
-```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/codex-loop.ps1
-全自动完成所有task
- powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/codex-loop.ps1 -RunUntilDone
-```
-
-如果你想把 `/goal` 作为外层 7x24 控制面来用，先读：
-
-- `docs/codex-harness-engineering/goal-harness-integration-guide.md`
-- `docs/codex-harness-engineering/examples/goal-templates.md`
-
-然后再在 Codex app 中设置 `/goal`。不要跳过 `task.json`、driver 或 stop hook，直接让 `/goal` 自由实现。
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/doctor.ps1
+powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/verify.ps1
+```
+
+如果需要先做环境诊断，再额外运行模板里的：
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File .\docs\codex-harness-engineering\templates\config\tools/install/env-check.ps1
+```
+
+### Step 6: 首次运行 driver
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/codex-loop.ps1
+全自动完成所有task
+ powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/codex-loop.ps1 -RunUntilDone
+```
+
+如果你想把 `/goal` 作为外层 7x24 控制面来用，先读：
+
+- `docs/codex-harness-engineering/goal-harness-integration-guide.md`
+- `docs/codex-harness-engineering/examples/goal-templates.md`
+
+然后再在 Codex app 中设置 `/goal`。不要跳过 `task.json`、driver 或 stop hook，直接让 `/goal` 自由实现。
 
 ## 5. 新环境初始化步骤
 
@@ -349,7 +349,7 @@ trust_level = "trusted"
 
 ### Step 6: hooks 只做增强，不做主链路
 
-Codex hooks 当前可作为增强层启用。Windows 环境不要把 hooks 当主链路，优先使用 driver；如需结束前 continuation / feedback gate，可再参考：
+Codex hooks 当前可作为增强层启用。Windows 环境不要把 hooks 当主链路，优先使用 driver；如需结束前 continuation / feedback gate，可再参考：
 
 - `templates/hooks/hooks.json`
 - `templates/hooks/hook-stop-verify.ps1`
@@ -362,44 +362,44 @@ Codex hooks 当前可作为增强层启用。Windows 环境不要把 hooks 当
 - 工具查找原则
 - 危险命令原则
 - 验证优先原则
-- dirty workspace 原则
-
-### 放在项目 `<repo>/AGENTS.md`
-
-- 当前项目任务入口
-- 当前项目代码地图入口
-- 当前项目测试命令
-- 当前项目目录边界
-- 当前项目阻塞格式
+- dirty workspace 原则
+
+### 放在项目 `<repo>/AGENTS.md`
+
+- 当前项目任务入口
+- 当前项目代码地图入口
+- 当前项目测试命令
+- 当前项目目录边界
+- 当前项目阻塞格式
 - 当前项目提交要求
 
-### 放在项目 `docs/harness/*.md`
+### 放在项目 `docs/harness/*.md`
 
 - 回归规则
 - trace 格式
 - sandbox 策略
 - CI 工作流
-- 架构说明
-
-### 放在项目 `docs/ai/repo-map.md`
-
-- 关键目录和模块职责
-- 真实入口和 truth source
-- 生成代码、敏感目录和禁改区
-- 常用验证命令
-- 最近更新时间和维护责任
+- 架构说明
+
+### 放在项目 `docs/ai/repo-map.md`
+
+- 关键目录和模块职责
+- 真实入口和 truth source
+- 生成代码、敏感目录和禁改区
+- 常用验证命令
+- 最近更新时间和维护责任
 
 ## 7. 最常见错误
 
 1. 把项目规则写进全局 AGENTS，导致换仓库就错。
 2. 把所有长文档都塞进 AGENTS，导致上下文挤爆。
 3. 新环境只复制项目模板，不准备全局 config。
-4. 没有 `tools/harness/doctor.ps1` 和 `tools/harness/verify.ps1` 就直接跑 driver。
-5. 在 dirty workspace 中自动提交。
-6. 把 hooks 当成 Windows 主链路。
-7. 没补验收示例和追溯矩阵就创建正式 `task.json`。
-8. 把 Stage 17 当成第一次定义测试范围的地方。
-9. 没有代码地图就让 Agent 在大型仓库里全量搜索。
+4. 没有 `tools/harness/doctor.ps1` 和 `tools/harness/verify.ps1` 就直接跑 driver。
+5. 在 dirty workspace 中自动提交。
+6. 把 hooks 当成 Windows 主链路。
+7. 没补验收示例和追溯矩阵就创建正式 `task.json`。
+8. 把 Stage 17 当成第一次定义测试范围的地方。
+9. 没有代码地图就让 Agent 在大型仓库里全量搜索。
 
 ## 8. 推荐复制路径
 
@@ -408,8 +408,8 @@ Codex hooks 当前可作为增强层启用。Windows 环境不要把 hooks 当
 | 全局规则     | `templates/config/global-AGENTS.md`                                                                          |
 | 全局配置     | `templates/config/global-config.toml`                                                                        |
 | 项目规则     | `templates/runtime/AGENTS.md`                                                                                 |
-| 项目任务流   | `templates/runtime/task.json`, `templates/runtime/codex-loop.ps1`, `templates/runtime/doctor.ps1`, `templates/runtime/verify.ps1` |
-| 项目文档     | `templates/docs/harness-architecture.md`, `templates/docs/new-project-usage.md`, `templates/docs/regression-rules.md`, `templates/docs/spec-to-ui-to-code-workflow.md`, `templates/docs/task-session-strategy.md`, `templates/docs/trace-format.md` |
-| 代码地图     | `templates/context/repo-map.md` |
-| 项目测试真相源 | `templates/testing/ACCEPTANCE_CRITERIA.md`, `templates/testing/ACCEPTANCE_EXAMPLES.md`, `templates/testing/TRACEABILITY_MATRIX.md`, `templates/testing/TEST_STRATEGY.md`, `templates/testing/TEST_DATA_MATRIX.md`, `templates/testing/RISK_BASED_TEST_PLAN.md`, `templates/testing/REGRESSION_PLAN.md`, `templates/testing/EVIDENCE_PROTOCOL.md`, `templates/testing/test-matrix.md`, `templates/testing/verify-matrix.md` |
-| 项目工具配置 | `templates/config/codex-config.toml`, `templates/config/mcp-config.toml`                                          |
+| 项目任务流   | `templates/runtime/task.json`, `templates/runtime/codex-loop.ps1`, `templates/runtime/doctor.ps1`, `templates/runtime/verify.ps1` |
+| 项目文档     | `templates/docs/harness-architecture.md`, `templates/docs/new-project-usage.md`, `templates/docs/regression-rules.md`, `templates/docs/spec-to-ui-to-code-workflow.md`, `templates/docs/task-session-strategy.md`, `templates/docs/trace-format.md` |
+| 代码地图     | `templates/context/repo-map.md` |
+| 项目测试真相源 | `templates/testing/ACCEPTANCE_CRITERIA.md`, `templates/testing/ACCEPTANCE_EXAMPLES.md`, `templates/testing/TRACEABILITY_MATRIX.md`, `templates/testing/TEST_STRATEGY.md`, `templates/testing/TEST_DATA_MATRIX.md`, `templates/testing/RISK_BASED_TEST_PLAN.md`, `templates/testing/REGRESSION_PLAN.md`, `templates/testing/EVIDENCE_PROTOCOL.md`, `templates/testing/test-matrix.md`, `templates/testing/verify-matrix.md` |
+| 项目工具配置 | `templates/config/codex-config.toml`, `templates/config/mcp-config.toml`                                          |