@pzy560117/codex-harness 0.1.3 → 0.1.5

package/package-source/docs/codex-harness-engineering/templates/hooks/hooks.json

@@ -1,40 +1,40 @@
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "startup|resume",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "pwsh -NoProfile -Command \"Write-Output 'Load project AGENTS.md and docs/harness before editing.'\"",
-            "statusMessage": "Loading harness context"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "pwsh -NoProfile -Command \"Write-Output 'PreToolUse policy placeholder'\"",
-            "statusMessage": "Checking shell policy"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "pwsh -NoProfile -Command \"& { & (Join-Path (git rev-parse --show-toplevel) 'tools/harness/hook-stop-verify.ps1') }\"",
-            "timeout": 120,
-            "statusMessage": "Running stop gate and continuation check"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "pwsh -NoProfile -Command \"Write-Output 'Load project AGENTS.md and docs/harness before editing.'\"",
+            "statusMessage": "Loading harness context"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "pwsh -NoProfile -Command \"Write-Output 'PreToolUse policy placeholder'\"",
+            "statusMessage": "Checking shell policy"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "pwsh -NoProfile -Command \"& { & (Join-Path (git rev-parse --show-toplevel) 'tools/harness/hook-stop-verify.ps1') }\"",
+            "timeout": 120,
+            "statusMessage": "Running stop gate and continuation check"
+          }
+        ]
+      }
+    ]
+  }
+}

package/package-source/docs/codex-harness-engineering/templates/knowledge/AGENTS.md

@@ -0,0 +1,16 @@
+# AGENTS.md
+
+## 目录作用
+
+- 存放项目知识层模板和示例知识条目。
+
+## 结构索引
+
+- `knowledge-catalog.md` / `catalog.md`：知识索引。
+- `decisions/`：决策记录示例。
+- `guidelines/`：指南类条目示例。
+
+## 修改规则
+
+- 这里是知识层模板，不要把一次性会话结论直接抬成规则。
+- 索引格式、成熟度语义和归档分层要与 `docs/knowledge-architecture.md` 一致。

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

@@ -1,6 +1,6 @@
-# Knowledge Item Catalog
-
-| ID | Type | Maturity | Title | Tags | Path |
-| --- | --- | --- | --- | --- | --- |
-| DECISION-HARNESS-001 | decision | draft | Harness 从执行闭环扩展为知识闭环 | harness, knowledge | `docs/knowledge/decisions/DECISION-HARNESS-001.md` |
-| GUIDELINE-RULES-001 | guideline | draft | 规则必须短入口、深文档、可验证 | rules, governance | `docs/knowledge/guidelines/GUIDELINE-RULES-001.md` |
+# Knowledge Item Catalog
+
+| ID | Type | Maturity | Title | Tags | Path |
+| --- | --- | --- | --- | --- | --- |
+| DECISION-HARNESS-001 | decision | draft | Harness 从执行闭环扩展为知识闭环 | harness, knowledge | `docs/knowledge/decisions/DECISION-HARNESS-001.md` |
+| GUIDELINE-RULES-001 | guideline | draft | 规则必须短入口、深文档、可验证 | rules, governance | `docs/knowledge/guidelines/GUIDELINE-RULES-001.md` |

package/package-source/docs/codex-harness-engineering/templates/knowledge/decisions/DECISION-HARNESS-001.md

@@ -1,39 +1,39 @@
----
-id: DECISION-HARNESS-001
-type: decision
-maturity: draft
-tags: [harness, knowledge]
-applicable_phases: [analysis, plan, implement, review, archive]
-source_references:
-  - docs/doc/Harness不是目的，知识才是护城河.md
-last_referenced:
-contributors:
-  - codex
----
-
-# Harness 从执行闭环扩展为知识闭环
-
-## Context
-
-当前 harness 已经能通过 `task.json`、`tools/harness/codex-loop.ps1`、验证命令、Stage 1/2 review、trace 和 commit gate 建立执行闭环，但缺少知识复用与归档机制。
-
-## Decision
-
-将 `docs/knowledge/` 作为项目级知识层，并在 trace、任务模板和归档阶段中显式记录知识引用与知识产出。
-
-## Consequences
-
-正面影响：
-
-- 后续任务可以复用已验证经验，减少重复推导。
-- review finding 和失败经验能沉淀为可检索资产。
-- 规则升级可以基于 proven 知识，而不是单次偏好。
-
-代价：
-
-- 需要维护 catalog 和条目成熟度。
-- 需要在归档阶段控制噪音，避免把一次性结论误升为规则。
-
-## Evidence
-
-本条来自 `docs/doc/` 中对 Harness Engineering 和知识沉淀实践的分析，初始成熟度为 `draft`。
+---
+id: DECISION-HARNESS-001
+type: decision
+maturity: draft
+tags: [harness, knowledge]
+applicable_phases: [analysis, plan, implement, review, archive]
+source_references:
+  - docs/doc/Harness不是目的，知识才是护城河.md
+last_referenced:
+contributors:
+  - codex
+---
+
+# Harness 从执行闭环扩展为知识闭环
+
+## Context
+
+当前 harness 已经能通过 `task.json`、`tools/harness/codex-loop.ps1`、验证命令、Stage 1/2 review、trace 和 commit gate 建立执行闭环，但缺少知识复用与归档机制。
+
+## Decision
+
+将 `docs/knowledge/` 作为项目级知识层，并在 trace、任务模板和归档阶段中显式记录知识引用与知识产出。
+
+## Consequences
+
+正面影响：
+
+- 后续任务可以复用已验证经验，减少重复推导。
+- review finding 和失败经验能沉淀为可检索资产。
+- 规则升级可以基于 proven 知识，而不是单次偏好。
+
+代价：
+
+- 需要维护 catalog 和条目成熟度。
+- 需要在归档阶段控制噪音，避免把一次性结论误升为规则。
+
+## Evidence
+
+本条来自 `docs/doc/` 中对 Harness Engineering 和知识沉淀实践的分析，初始成熟度为 `draft`。

package/package-source/docs/codex-harness-engineering/templates/knowledge/guidelines/GUIDELINE-RULES-001.md

@@ -1,30 +1,30 @@
----
-id: GUIDELINE-RULES-001
-type: guideline
-maturity: draft
-tags: [rules, governance, context]
-applicable_phases: [analysis, plan, implement, review]
-source_references:
-  - docs/doc/1.md
-last_referenced:
-contributors:
-  - codex
----
-
-# 规则必须短入口、深文档、可验证
-
-## Context
-
-根规则过长会消耗指令预算，孤立深文档又容易不被发现。当前仓库已经有 `AGENTS.md`、`docs/harness/*`、`.codex/rules/*` 和 `.codex/prompts/*` 多层规则面，需要明确分层。
-
-## Guidance
-
-- `AGENTS.md` 只保留每次会话必须遵守的硬约束和深文档索引。
-- 复杂流程写入 `docs/harness/*` 或 `.codex/rules/*`。
-- 执行时必须注入的行为写入 `.codex/prompts/*`。
-- 禁令必须包含替代方案。
-- 能自动检查的规则应进入脚本、schema 或 hook，而不是只靠文字约束。
-
-## Evidence
-
-本条来自 `docs/doc/1.md` 的规则工程分析，初始成熟度为 `draft`。
+---
+id: GUIDELINE-RULES-001
+type: guideline
+maturity: draft
+tags: [rules, governance, context]
+applicable_phases: [analysis, plan, implement, review]
+source_references:
+  - docs/doc/1.md
+last_referenced:
+contributors:
+  - codex
+---
+
+# 规则必须短入口、深文档、可验证
+
+## Context
+
+根规则过长会消耗指令预算，孤立深文档又容易不被发现。当前仓库已经有 `AGENTS.md`、`docs/harness/*`、`.codex/rules/*` 和 `.codex/prompts/*` 多层规则面，需要明确分层。
+
+## Guidance
+
+- `AGENTS.md` 只保留每次会话必须遵守的硬约束和深文档索引。
+- 复杂流程写入 `docs/harness/*` 或 `.codex/rules/*`。
+- 执行时必须注入的行为写入 `.codex/prompts/*`。
+- 禁令必须包含替代方案。
+- 能自动检查的规则应进入脚本、schema 或 hook，而不是只靠文字约束。
+
+## Evidence
+
+本条来自 `docs/doc/1.md` 的规则工程分析，初始成熟度为 `draft`。

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

@@ -1,41 +1,41 @@
-# Knowledge Catalog
-
-本目录保存当前项目的可复用知识。Codex 会话应先读本文件，再按需读取 `catalog.md` 和具体条目。
-
-## 查询顺序
-
-1. 当前任务涉及 harness、规则、driver、trace、模板或 prompt 时，先读 `docs/harness/knowledge-architecture.md`。
-2. 需要查找已有经验时，读 `docs/knowledge/catalog.md`。
-3. 只读取与当前任务直接相关的完整条目。
-
-## 维护入口
-
-- 冷启动导入：`docs/harness/knowledge-import.md`
-- 健康检查：`docs/harness/knowledge-lint.md`
-- 架构协议：`docs/harness/knowledge-architecture.md`
-
-## 分类
-
-| 分类 | 路径 | 用途 |
-| --- | --- | --- |
-| Models | `docs/knowledge/models/` | 实体、结构、关系 |
-| Decisions | `docs/knowledge/decisions/` | 架构决策、取舍和原因 |
-| Guidelines | `docs/knowledge/guidelines/` | 推荐做法、禁止做法和替代方案 |
-| Pitfalls | `docs/knowledge/pitfalls/` | 已知风险、失败模式、排查步骤 |
-| Processes | `docs/knowledge/processes/` | 可重复工作流和操作步骤 |
-| Archive | `docs/knowledge/archive/` | 过时、低置信或待合并条目 |
-
-## 阶段推荐
-
-| 阶段 | 优先知识类型 |
-| --- | --- |
-| analysis | `model`、`process`、`pitfall` |
-| design | `decision`、`guideline`、`model` |
-| plan | `decision`、`process`、`pitfall` |
-| implement | `guideline`、`pitfall` |
-| review | `guideline`、`pitfall`、`decision` |
-| archive | 所有类型 |
-
-## 当前状态
-
-当前知识库处于 cold start。新增条目默认 maturity 为 `draft`，需要通过 trace 引用和验证证据逐步提升。
+# Knowledge Catalog
+
+本目录保存当前项目的可复用知识。Codex 会话应先读本文件，再按需读取 `catalog.md` 和具体条目。
+
+## 查询顺序
+
+1. 当前任务涉及 harness、规则、driver、trace、模板或 prompt 时，先读 `docs/harness/knowledge-architecture.md`。
+2. 需要查找已有经验时，读 `docs/knowledge/catalog.md`。
+3. 只读取与当前任务直接相关的完整条目。
+
+## 维护入口
+
+- 冷启动导入：`docs/harness/knowledge-import.md`
+- 健康检查：`docs/harness/knowledge-lint.md`
+- 架构协议：`docs/harness/knowledge-architecture.md`
+
+## 分类
+
+| 分类 | 路径 | 用途 |
+| --- | --- | --- |
+| Models | `docs/knowledge/models/` | 实体、结构、关系 |
+| Decisions | `docs/knowledge/decisions/` | 架构决策、取舍和原因 |
+| Guidelines | `docs/knowledge/guidelines/` | 推荐做法、禁止做法和替代方案 |
+| Pitfalls | `docs/knowledge/pitfalls/` | 已知风险、失败模式、排查步骤 |
+| Processes | `docs/knowledge/processes/` | 可重复工作流和操作步骤 |
+| Archive | `docs/knowledge/archive/` | 过时、低置信或待合并条目 |
+
+## 阶段推荐
+
+| 阶段 | 优先知识类型 |
+| --- | --- |
+| analysis | `model`、`process`、`pitfall` |
+| design | `decision`、`guideline`、`model` |
+| plan | `decision`、`process`、`pitfall` |
+| implement | `guideline`、`pitfall` |
+| review | `guideline`、`pitfall`、`decision` |
+| archive | 所有类型 |
+
+## 当前状态
+
+当前知识库处于 cold start。新增条目默认 maturity 为 `draft`，需要通过 trace 引用和验证证据逐步提升。