@pzy560117/codex-harness 0.1.3 → 0.1.5

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

@@ -17,20 +17,20 @@ Codex 全局规则要短、稳、跨项目成立。它应该管“行为边界
 
 | 层级 | 文件 | 应放内容 | 不应放内容 |
 | --- | --- | --- | --- |
-| 全局行为规则 | `~/.codex/AGENTS.md` | 输出语言、工具查找、Git 安全、验证习惯、Windows 注意事项 | 具体项目的目录结构、业务规则、任务队列、多 Agent 阶段细节 |
-| 全局运行配置 | `~/.codex/config.toml` | 默认模型、sandbox、approval、shell environment、全局 features | token、项目专属 MCP、项目私有环境变量、普通项目规则 |
-| 项目入口规则 | `<repo>/AGENTS.md` | 本仓库任务规则、提交规则、目录边界、driver 规则 | 跨项目通用工具路径、个人偏好长文 |
-| 项目运行配置 | `<repo>/.codex/config.toml` | 项目专属 MCP、项目 profile、可信项目 sandbox 策略 | 个人全局习惯、其他项目路径、普通项目规则 |
-| 长文档 | `<repo>/docs/` | 19 阶段流程、测试矩阵、架构、trace、CI、回归策略 | 简短必须遵守的入口规则 |
+| 全局行为规则 | `~/.codex/AGENTS.md` | 输出语言、工具查找、Git 安全、验证习惯、Windows 注意事项 | 具体项目的目录结构、业务规则、任务队列、多 Agent 阶段细节 |
+| 全局运行配置 | `~/.codex/config.toml` | 默认模型、sandbox、approval、shell environment、全局 features | token、项目专属 MCP、项目私有环境变量、普通项目规则 |
+| 项目入口规则 | `<repo>/AGENTS.md` | 本仓库任务规则、提交规则、目录边界、driver 规则 | 跨项目通用工具路径、个人偏好长文 |
+| 项目运行配置 | `<repo>/.codex/config.toml` | 项目专属 MCP、项目 profile、可信项目 sandbox 策略 | 个人全局习惯、其他项目路径、普通项目规则 |
+| 长文档 | `<repo>/docs/` | 19 阶段流程、测试矩阵、架构、trace、CI、回归策略 | 简短必须遵守的入口规则 |
 
 判断标准:
 
 - 换一个项目仍然成立，放全局。
 - 只对当前仓库成立，放项目 `AGENTS.md`。
 - 需要长篇解释或模板，放项目 `docs/`。
-- 会影响 Codex CLI 行为，放 `config.toml`。
-- `developer_instructions` 和 `model_instructions_file` 是上下文入口，不是普通配置注释区；默认不用它们承载项目规则。
-- 包含 token、cookie、密码、私钥，不放任何仓库文档。
+- 会影响 Codex CLI 行为，放 `config.toml`。
+- `developer_instructions` 和 `model_instructions_file` 是上下文入口，不是普通配置注释区；默认不用它们承载项目规则。
+- 包含 token、cookie、密码、私钥，不放任何仓库文档。
 
 ---
 
@@ -75,7 +75,7 @@ Codex 全局规则要短、稳、跨项目成立。它应该管“行为边界
 
 ## Git 与安全规则
 
-- dirty workspace 默认视为阻塞，除非用户明确说明哪些改动属于当前任务。
+- dirty workspace 默认视为阻塞，除非用户明确说明哪些改动属于当前任务。
 - 禁止在未确认时使用破坏性命令，如 `git reset --hard`、`git checkout --`、递归删除。
 - 不把 token、cookie、私钥、密码写入仓库、trace 或文档。
 - 不在不可信环境使用高权限 sandbox。
@@ -83,7 +83,7 @@ Codex 全局规则要短、稳、跨项目成立。它应该管“行为边界
 ## Windows 环境规则
 
 - Windows 主链路优先使用 PowerShell driver。
-- Codex hooks 可作为增强层启用；Windows 仍不把 hooks 当主链路。
+- Codex hooks 可作为增强层启用；Windows 仍不把 hooks 当主链路。
 - 需要内联多步验证时，不要让前一个命令失败被后一个命令的退出码掩盖，应显式检查 `$LASTEXITCODE`。
 
 ## 分层规则
@@ -122,7 +122,7 @@ inherit = "all"
 ignore_default_excludes = true
 
 [features]
-codex_hooks = true
+codex_hooks = true
 
 # 全局只放跨项目稳定设置。
 # 项目专属 MCP、env、trust、danger-full-access profile 放 `<repo>/.codex/config.toml`。
@@ -139,13 +139,13 @@ codex_hooks = true
 
 不建议放全局:
 
-- 项目私有 MCP server。
-- 真实 API key、数据库密码、cookie。
-- 某个项目专用的 `danger-full-access` 默认策略。
-- 某个仓库的绝对路径。
-- 只服务一个项目的 profile。
-- 普通项目规则、长流程或历史解释。
-- `model_instructions_file` 这类会覆盖基础指令层的高风险入口。
+- 项目私有 MCP server。
+- 真实 API key、数据库密码、cookie。
+- 某个项目专用的 `danger-full-access` 默认策略。
+- 某个仓库的绝对路径。
+- 只服务一个项目的 profile。
+- 普通项目规则、长流程或历史解释。
+- `model_instructions_file` 这类会覆盖基础指令层的高风险入口。
 
 ---
 
@@ -154,19 +154,19 @@ codex_hooks = true
 项目配置用于补充当前仓库的运行策略。对于 Harness 项目，建议从 `templates/config/codex-config.toml` 复制，再按项目删减。
 
 ```toml
-model = "gpt-5.4"
-model_reasoning_effort = "medium"
-sandbox_mode = "workspace-write"
-project_doc_max_bytes = 65536
-
-# 默认项目模板会安装根 AGENTS.md，因此不设置 fallback。
-# 旧项目没有 AGENTS.md 且真实存在 TEAM_GUIDE.md / .agents.md 时，再按项目显式添加。
-
-[approvals]
-approval_policy = "on-request"
+model = "gpt-5.4"
+model_reasoning_effort = "medium"
+sandbox_mode = "workspace-write"
+project_doc_max_bytes = 65536
+
+# 默认项目模板会安装根 AGENTS.md，因此不设置 fallback。
+# 旧项目没有 AGENTS.md 且真实存在 TEAM_GUIDE.md / .agents.md 时，再按项目显式添加。
+
+[approvals]
+approval_policy = "on-request"
 
 [features]
-codex_hooks = true
+codex_hooks = true
 
 [agents]
 max_threads = 4
@@ -216,17 +216,17 @@ approval_policy = "never"
 sandbox_mode = "workspace-write"
 ```
 
-项目 profile 只提供 Codex CLI 的执行配置；真正的阶段到 agent 路由仍以这些文件为准:
-
-- `.codex/rules/agents.md`
-
-项目 `.codex/config.toml` 的边界:
-
-- 整个 TOML 不会作为项目规则正文进入模型上下文。
-- `developer_instructions` 会注入 session，默认不用；普通规则放 `AGENTS.md`。
-- `model_instructions_file` 会覆盖 built-in base instructions，默认禁用。
-- `.rules` 是命令执行策略，不是项目 instruction。
-- hooks 配置不是上下文；hook 输出 `additionalContext` 时才按动态上下文治理。
+项目 profile 只提供 Codex CLI 的执行配置；真正的阶段到 agent 路由仍以这些文件为准:
+
+- `.codex/rules/agents.md`
+
+项目 `.codex/config.toml` 的边界:
+
+- 整个 TOML 不会作为项目规则正文进入模型上下文。
+- `developer_instructions` 会注入 session，默认不用；普通规则放 `AGENTS.md`。
+- `model_instructions_file` 会覆盖 built-in base instructions，默认禁用。
+- `.rules` 是命令执行策略，不是项目 instruction。
+- hooks 配置不是上下文；hook 输出 `additionalContext` 时才按动态上下文治理。
 
 ---
 
@@ -269,7 +269,7 @@ Get-Command git, rg, node, python, pwsh -ErrorAction Continue
 - [ ] `~/.codex/AGENTS.md` 没有 token、cookie、私钥、密码。
 - [ ] `~/.codex/config.toml` 没有真实密钥。
 - [ ] 默认 sandbox 不是无条件 `danger-full-access`。
-- [ ] hooks 在 Windows 环境中只作为增强层，不替代 PowerShell driver 主链路。
+- [ ] hooks 在 Windows 环境中只作为增强层，不替代 PowerShell driver 主链路。
 - [ ] 项目根 `AGENTS.md` 仍负责项目专属规则。
 - [ ] 文档改动已运行 `git diff --check`。
 
@@ -281,12 +281,12 @@ Get-Command git, rg, node, python, pwsh -ErrorAction Continue
 
 多 Agent 阶段路由放在项目或 Harness 层:
 
-- Stage 02 需求分析: `product-analyst`，同时产出可执行验收示例和可测试需求边界
-- Stage 03 需求追溯: `requirements-trace-analyst`，把 Requirement IDs 固化到 `TRACEABILITY_MATRIX`
-- Stage 09 多 Agent 派发: `orchestrator`
-- Stage 10 前端实现: `frontend-worker`
-- Stage 13 后端实现: `backend-worker`
-- Stage 17 验证回归: `test-runner`，只运行 fresh evidence、affected tests 和 P0 回归，不在本阶段第一次补测试范围
-- Stage 19 合并提交: `release-manager`
+- Stage 02 需求分析: `product-analyst`，同时产出可执行验收示例和可测试需求边界
+- Stage 03 需求追溯: `requirements-trace-analyst`，把 Requirement IDs 固化到 `TRACEABILITY_MATRIX`
+- Stage 09 多 Agent 派发: `orchestrator`
+- Stage 10 前端实现: `frontend-worker`
+- Stage 13 后端实现: `backend-worker`
+- Stage 17 验证回归: `test-runner`，只运行 fresh evidence、affected tests 和 P0 回归，不在本阶段第一次补测试范围
+- Stage 19 合并提交: `release-manager`
 
 这样分层后，全局规则可以长期稳定，项目 Harness 可以按业务和阶段持续演进。

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

@@ -0,0 +1,14 @@
+# AGENTS.md
+
+## 目录作用
+
+- 存放示例工程文档的 package-assets 镜像。
+
+## 结构索引
+
+- `ticket-filter-demo/`：完整示例工程文档镜像。
+
+## 修改规则
+
+- 先判断是否应修改上游示例目录 `docs/codex-harness-engineering/examples/*`。
+- 这里只负责镜像分发，不作为示例 canonical。