@pzy560117/codex-harness 0.1.3 → 0.1.4

package/package-source/docs/codex-harness-engineering/templates/README.md

@@ -1,20 +1,21 @@
-# Templates README
-
-当前模板集只保留单工作区、单 driver 的最小闭环。
-
-## 主要目录
-
-- `runtime/`: 项目根运行入口、driver、doctor、任务队列、运行策略、验证脚本
-- `config/`: 全局与项目级配置示例
-- `docs/`: 会复制到项目 `docs/harness/` 的文档模板，也包含 `project-agents-template.md` 这种按项目事实生成 `AGENTS.md` 的通用规则模板
-- `design/`: 前端先行链路的设计 brief、图转前端规格、组件映射、状态矩阵、视觉评审、前端架构和 design tokens 模板
-- `testing/`: 测试左移模板，包含验收标准、验收示例、追溯矩阵、测试数据、回归计划、失败归因和 verify 矩阵
-- `prompts/`: driver、review、visual、failure、repair 使用的提示词模板
-- `trace/`: trace 与 schema 示例
-- `package-assets/`: 会复制到目标项目 `.agents/` 的能力包与安装入口镜像
-
-已移除：
-
-- 额外执行工作区脚本
-- 外部 worker 编排模板
-- 控制面状态模板
+# Templates README
+
+当前模板集只保留单工作区、单 driver 的最小闭环。
+
+## 主要目录
+
+- `runtime/`: 项目根运行入口、driver、doctor、任务队列、运行策略、验证脚本
+- `config/`: 全局与项目级配置示例
+- `docs/`: 会复制到项目 `docs/harness/` 的文档模板，也包含 `project-agents-template.md` 这种按项目事实生成 `AGENTS.md` 的通用规则模板
+- `tools/`: 会复制到项目 `tools/harness/` 的内容级门禁脚本模板，例如 spec/context/architecture/directory/style/session/docs/data/integration/mobile/acceptance lint
+- `design/`: 前端先行链路的设计 brief、图转前端规格、组件映射、状态矩阵、视觉评审、前端架构和 design tokens 模板
+- `testing/`: 测试左移模板，包含验收标准、验收示例、追溯矩阵、测试数据、回归计划、失败归因和 verify 矩阵
+- `prompts/`: driver、review、visual、failure、repair 使用的提示词模板
+- `trace/`: trace 与 schema 示例
+- `package-assets/`: 会复制到目标项目 `.agents/` 的能力包与安装入口镜像
+
+已移除：
+
+- 额外执行工作区脚本
+- 外部 worker 编排模板
+- 控制面状态模板

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/init-autopilot/SKILL.md

@@ -84,21 +84,23 @@ powershell -NoProfile -ExecutionPolicy Bypass -File .\tools/harness/codex-loop.p
 1. 优先执行任务自己的 `test_command`
 2. 若没有 `test_command`，再按项目默认验证方式执行
 3. 验证失败时，禁止标记完成
-4. 代码、`task.json`、`progress.txt` 应尽量放在同一个提交里
-5. 不要回滚与当前任务无关的现有改动
-
-### 测试实践映射防漂移
-
-当任务涉及 `task.json`、`package.json` scripts、`tests/`、`docs/testing/verify-matrix.md`、release gate 或 mock/local/docker/live evidence 边界时，必须先检查并保持测试实践映射：
-
-1. 每个关键 test script 必须有明确 task 归属，不能只有 `package.json` 脚本或只有 release 总门禁。
-2. `task.json` 中相关任务必须写清 `test_command`、需求范围、依赖形态和 evidence 边界。
-3. `docs/testing/verify-matrix.md` 必须有“测试实践到 task 映射”或等价表，列出 test script、task id、需求范围、依赖形态和 evidence 边界。
-4. mock/local rehearsal、docker/mock release、外部 live 验证必须分开描述，不能互相替代。
-5. 如果仓库存在 `tests/mock-local/test-practice-matrix.test.mjs` 或同类守护测试，修改上述文件后必须运行覆盖它的测试命令，例如 `npm run test:mock-local`。
-6. 新增、删除或改名 test script 时，同步更新 task、verify-matrix 和守护测试；否则不得把任务标记为完成。
-
-## 阻塞处理
+4. 代码、`task.json`、`progress.txt` 应尽量放在同一个提交里
+5. 不要回滚与当前任务无关的现有改动
+
+### 测试实践映射防漂移
+
+当任务涉及 `task.json`、`package.json` scripts、`tests/`、`docs/testing/verify-matrix.md`、release gate 或 mock/local/docker/live evidence 边界时，必须先检查并保持测试实践映射：
+
+如果当前仓库是 thin install 项目且 `docs/testing/*` 缺失，先读取 `.codex-harness/state/config.json`，再到 `packageRoot` 下读取对应 testing truth source。
+
+1. 每个关键 test script 必须有明确 task 归属，不能只有 `package.json` 脚本或只有 release 总门禁。
+2. `task.json` 中相关任务必须写清 `test_command`、需求范围、依赖形态和 evidence 边界。
+3. `docs/testing/verify-matrix.md` 必须有“测试实践到 task 映射”或等价表，列出 test script、task id、需求范围、依赖形态和 evidence 边界。
+4. mock/local rehearsal、docker/mock release、外部 live 验证必须分开描述，不能互相替代。
+5. 如果仓库存在 `tests/mock-local/test-practice-matrix.test.mjs` 或同类守护测试，修改上述文件后必须运行覆盖它的测试命令，例如 `npm run test:mock-local`。
+6. 新增、删除或改名 test script 时，同步更新 task、verify-matrix 和守护测试；否则不得把任务标记为完成。
+
+## 阻塞处理
 
 遇到下列情况立即停止自动续跑：
 

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/log-analysis-optimization/SKILL.md

@@ -240,8 +240,8 @@ grep -i "retry" console.log
 
 ---
 
-## 相关 Skills
-
-- `skills/midscene-log-analysis/SKILL.md` - 基础日志分析
-- `skills/midscene-framework/SKILL.md` - 框架开发指南
-- `skills/error-handling/SKILL.md` - 错误处理技巧
+## 相关 Skills
+
+- `skills/midscene-log-analysis/SKILL.md` - 基础日志分析
+- `skills/midscene-framework/SKILL.md` - 框架开发指南
+- `skills/error-handling/SKILL.md` - 错误处理技巧

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/SKILL.md

@@ -38,37 +38,37 @@ description: 撰写产品需求文档(PRD)并生成可交互原型。触发条
 
 使用 [references/prd-template.md](references/prd-template.md) 生成完整 PRD。
 
-### 阶段4：原型生成
-
-本 skill 直接复用同级 [ui-ux-pro-max](../ui-ux-pro-max/SKILL.md) 的脚本和数据，不再维护内嵌副本。
-
-#### Step 1: 生成设计系统
-
-```bash
-python3 ../ui-ux-pro-max/scripts/search.py "<产品类型> <风格>" --design-system -p "项目名"
-```
-
-示例：
-```bash
-python3 ../ui-ux-pro-max/scripts/search.py "travel mobile app" --design-system -p "旅行App"
-python3 ../ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system -p "分析平台"
-```
+### 阶段4：原型生成
+
+本 skill 直接复用同级 [ui-ux-pro-max](../ui-ux-pro-max/SKILL.md) 的脚本和数据，不再维护内嵌副本。
+
+#### Step 1: 生成设计系统
+
+```bash
+python3 ../ui-ux-pro-max/scripts/search.py "<产品类型> <风格>" --design-system -p "项目名"
+```
+
+示例：
+```bash
+python3 ../ui-ux-pro-max/scripts/search.py "travel mobile app" --design-system -p "旅行App"
+python3 ../ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system -p "分析平台"
+```
 
 #### Step 2: 按需获取详细设计数据
 
-```bash
-# 配色方案
-python3 ../ui-ux-pro-max/scripts/search.py "modern elegant" --domain color
-
-# 字体配对
-python3 ../ui-ux-pro-max/scripts/search.py "professional" --domain typography
-
-# UX 准则
-python3 ../ui-ux-pro-max/scripts/search.py "mobile form" --domain ux
-
-# 技术栈指南
-python3 ../ui-ux-pro-max/scripts/search.py "responsive" --stack html-tailwind
-```
+```bash
+# 配色方案
+python3 ../ui-ux-pro-max/scripts/search.py "modern elegant" --domain color
+
+# 字体配对
+python3 ../ui-ux-pro-max/scripts/search.py "professional" --domain typography
+
+# UX 准则
+python3 ../ui-ux-pro-max/scripts/search.py "mobile form" --domain ux
+
+# 技术栈指南
+python3 ../ui-ux-pro-max/scripts/search.py "responsive" --stack html-tailwind
+```
 
 可用 domain: `style`, `color`, `typography`, `ux`, `product`, `landing`, `chart`
 可用 stack: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `shadcn`, `swiftui`, `react-native`, `flutter`

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-e2e-planner/SKILL.md

@@ -15,17 +15,17 @@ description: 专门扫描前端工程，生成零幻觉、元素级的端到端
 
 严格按照 **"扫描 -> 计划 -> 审核 -> 生成任务"** 的顺序执行，不得越级跳步：
 
-1. **深度扫描组件 (Mock & DOM 提取)**
-   - 若项目存在 `docs/ai/repo-map.md`、`docs/context/repo-map.md` 或同类 codemap，先阅读导航文件定位前端入口、路由、状态源和测试相关目录，再进入具体组件；禁止上来就全仓盲扫。
-   - 必须通过底层文件 API (`find_by_name` / `list_dir` / `view_file`) 全面读取当前正在开发或测试的 Vue/React 视图组件文件。
-   - 提取 `<template>` 中所有的交互式控件，例如：`<button>`、`<input>`、`<select>` 等。
-   - 通过 `grep_search` 或深度读取，检索代码中 `mock`、`MockStateWrapper` 等硬编码虚拟数据的痕迹。
-
-2. **导出标准化测试大纲 (e2e-plan.md)**
-   - 根据收集到的待测点与排雷点，调用模板 `.agents/.specify/templates/e2e-plan-template.md`。
-   - 分章节输出：**代码入口与影响面**、**Mock 排雷清单**、**各页面元素级断言**（即测试用例）、**CRUD 闭环业务流**。
-   - ⚠️ **输出路径强制规范**：必须使用 `write_to_file` 将文件写入**项目根目录**（即与 `frontend/`、`backend/` 同级），路径为 `<项目根路径>/e2e-plan.md`。**绝对禁止**将此文件写入 artifact 目录（`~/.gemini/...`）。
-   - **注意**：大纲生成完毕后必须立即挂起操作。
+1. **深度扫描组件 (Mock & DOM 提取)**
+   - 若项目存在 `docs/ai/repo-map.md`、`docs/context/repo-map.md` 或同类 codemap，先阅读导航文件定位前端入口、路由、状态源和测试相关目录，再进入具体组件；禁止上来就全仓盲扫。
+   - 必须通过底层文件 API (`find_by_name` / `list_dir` / `view_file`) 全面读取当前正在开发或测试的 Vue/React 视图组件文件。
+   - 提取 `<template>` 中所有的交互式控件，例如：`<button>`、`<input>`、`<select>` 等。
+   - 通过 `grep_search` 或深度读取，检索代码中 `mock`、`MockStateWrapper` 等硬编码虚拟数据的痕迹。
+
+2. **导出标准化测试大纲 (e2e-plan.md)**
+   - 根据收集到的待测点与排雷点，调用模板 `.agents/.specify/templates/e2e-plan-template.md`。
+   - 分章节输出：**代码入口与影响面**、**Mock 排雷清单**、**各页面元素级断言**（即测试用例）、**CRUD 闭环业务流**。
+   - ⚠️ **输出路径强制规范**：必须使用 `write_to_file` 将文件写入**项目根目录**（即与 `frontend/`、`backend/` 同级），路径为 `<项目根路径>/e2e-plan.md`。**绝对禁止**将此文件写入 artifact 目录（`~/.gemini/...`）。
+   - **注意**：大纲生成完毕后必须立即挂起操作。
 
 3. **🚧 强制人工Review拦截点 (Mandatory User Review) 🚧**
    - 此时**严禁直接生成 Tasks 或去执行**。

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-e2e-runner/SKILL.md

@@ -13,15 +13,15 @@ description: 根据 e2e-plan.md 纯粹地唤起并调度 browser_subagent 进行
 
 ## 工作流 (Workflow)
 
-1. **装载测试计划**
-   - 若项目存在 `docs/ai/repo-map.md`、`docs/context/repo-map.md` 或同类 codemap，先读取导航文件确认页面入口、路由、状态源和关联测试目录，再切入 `e2e-plan.md`。
-   - 解读 `e2e-plan.md` 中的所有元素和交互基准，特别是 **代码入口与影响面**、**10 维度断言** 和 **CRUD 全生命周期测试流水线**。
+1. **装载测试计划**
+   - 若项目存在 `docs/ai/repo-map.md`、`docs/context/repo-map.md` 或同类 codemap，先读取导航文件确认页面入口、路由、状态源和关联测试目录，再切入 `e2e-plan.md`。
+   - 解读 `e2e-plan.md` 中的所有元素和交互基准，特别是 **代码入口与影响面**、**10 维度断言** 和 **CRUD 全生命周期测试流水线**。
 
 2. **执行自动化测试闭环**
    - 唤起执行测试的主程序 (通过 `browser_subagent` 或者关联测试框架驱动如 Playwright/Cypress，取决于本地支持)。
    - 按章节逐页面点击所有的 `<button>`，输入各类异常、边界值至 `<input>` 表单中。
    - 执行生命周期流程：让测试机器人走完从创建 (Create)、查看 (Read)、更新 (Update) 至终结删除 (Delete) 闭环。
 
-3. **收录与报告输出**
-   - 构建 `qa-e2e-report.md` 测试报告文件，对比原计划中的每一个勾选项标记 Pass 或是 Fail。
-   - 如果发生阻断错误（Fail），先按 `TEST_CODE_ISSUE / PRODUCT_BUG / REQUIREMENT_CHANGE / ENV_OR_DATA_ISSUE / FLAKY` 做一级分类，再提供详尽的终端输出日志摘录或页面元素截图证据供研发人员回溯修复。
+3. **收录与报告输出**
+   - 构建 `qa-e2e-report.md` 测试报告文件，对比原计划中的每一个勾选项标记 Pass 或是 Fail。
+   - 如果发生阻断错误（Fail），先按 `TEST_CODE_ISSUE / PRODUCT_BUG / REQUIREMENT_CHANGE / ENV_OR_DATA_ISSUE / FLAKY` 做一级分类，再提供详尽的终端输出日志摘录或页面元素截图证据供研发人员回溯修复。

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qa-mock-cleaner/SKILL.md

@@ -13,10 +13,10 @@ description: 专门依据 e2e-plan.md 执行前端 Mock 数据依赖的扫除行
 
 ## 工作流 (Workflow)
 
-1. **获取排雷计划**
-   - 若项目存在 `docs/ai/repo-map.md`、`docs/context/repo-map.md` 或同类 codemap，先读取导航文件定位页面入口、Mock 所在目录和真实接口边界。
-   - 读取目标路径中的 `e2e-plan.md` 文件的 "代码入口与影响面"、"Mock 依赖排雷清单" 章节。
-   - 精准定位被指出的那些 `.vue` 页面文件或 `src/mock/` 目录下的拦截文件。
+1. **获取排雷计划**
+   - 若项目存在 `docs/ai/repo-map.md`、`docs/context/repo-map.md` 或同类 codemap，先读取导航文件定位页面入口、Mock 所在目录和真实接口边界。
+   - 读取目标路径中的 `e2e-plan.md` 文件的 "代码入口与影响面"、"Mock 依赖排雷清单" 章节。
+   - 精准定位被指出的那些 `.vue` 页面文件或 `src/mock/` 目录下的拦截文件。
 
 2. **精细化剥离与真实接口替换**
    - 针对文件内的 `<MockStateWrapper>` 进行剥离，改为通过 axios 或 Vue store 调用真实后端接口的错误/加载捕获机制。

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/SKILL.md

@@ -1,67 +1,67 @@
----
-name: "qoder-codex-api-config"
-description: "Use when configuring local Qoder/Qoder CLI to use the current Codex API settings, including writing Qoder custom model records, encrypted SecretStorage API keys, and default model selections on Windows."
----
-
-# Qoder Codex API Config
-
-用于把当前 Codex 的 API 配置写入本机 Qoder 配置。适用场景：
-
-- 用户要求“配置 Qoder 使用当前 Codex API”
-- 用户要求“把 Codex 的 API/模型接到 Qoder”
-- 用户要求“直接修改 Qoder 配置”
-
-## 核心规则
-
-- 不把 API key 明文写入仓库、日志或普通 JSON 配置。
-- 写入前检查 Qoder 是否正在运行；正在运行时默认停止并让用户关闭 Qoder，避免 Qoder 退出时覆盖 SQLite。
-- 写入前备份 `User/globalStorage/state.vscdb` 及同名 `-wal`、`-shm`。
-- 默认从 `C:\Users\<user>\.codex\config.toml` 读取 `model`、当前 `model_provider` 和对应 provider 的 `base_url`。
-- 默认从 `C:\Users\<user>\.codex\auth.json` 读取 `OPENAI_API_KEY`，用 Qoder `Local State` 的 Chromium OSCrypt key 加密后写入 `secret://aicoding.customModel.apiKey.<model_id>`。
-
-## 一步配置
-
-运行 bundled 脚本：
-
-```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -File .agents\skills\qoder-codex-api-config\scripts\configure-qoder-codex-api.ps1
-```
-
-常用覆盖参数：
-
-```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -File .agents\skills\qoder-codex-api-config\scripts\configure-qoder-codex-api.ps1 `
-  -Model "gpt-5.5" `
-  -BaseUrl "http://47.250.148.224" `
-  -Alias "Codex GPT-5.5" `
-  -Provider "openai" `
-  -ByokTypeKey "openai"
-```
-
-## 写入内容
-
-脚本会写入：
-
-- `aicoding.customModels`: Qoder custom model 数组
-- `secret://aicoding.customModel.apiKey.<model_id>`: 加密后的 API key
-- `chat.modelConfig.assistant`: `custom:<model_id>`
-- `chat.modelConfig.experts`: `custom:<model_id>`
-- `aicoding.aicoding-agent`: `globalstate-selected-models` 中的 chat/assistant
-- `__$__targetStorageMarker`: 补充相关 storage scope marker
-
-默认模型 ID 会从模型名生成，例如 `gpt-5.5` -> `model_codex_gpt_5_5`。
-
-## 验证
-
-配置后脚本会验证：
-
-- `aicoding.customModels` 是数组且包含目标模型
-- SecretStorage 记录可被当前 Windows 用户解密，且和 Codex API key 一致
-- 默认模型选择已写入
-
-如果 Qoder 启动后仍不显示该模型，优先检查：
-
-1. Qoder 是否在写入时仍在运行。
-2. Qoder 后端是否允许 BYOK，自定义模型功能可能受账号/远端开关控制。
-3. Qoder 实际 provider 是否接受 `Provider`/`ByokTypeKey`，默认使用 `openai`。
-4. Codex 当前 `wire_api` 可能是 `responses`，而 Qoder BYOK 后端可能只支持 provider 自身协议。
+---
+name: "qoder-codex-api-config"
+description: "Use when configuring local Qoder/Qoder CLI to use the current Codex API settings, including writing Qoder custom model records, encrypted SecretStorage API keys, and default model selections on Windows."
+---
+
+# Qoder Codex API Config
+
+用于把当前 Codex 的 API 配置写入本机 Qoder 配置。适用场景：
+
+- 用户要求“配置 Qoder 使用当前 Codex API”
+- 用户要求“把 Codex 的 API/模型接到 Qoder”
+- 用户要求“直接修改 Qoder 配置”
+
+## 核心规则
+
+- 不把 API key 明文写入仓库、日志或普通 JSON 配置。
+- 写入前检查 Qoder 是否正在运行；正在运行时默认停止并让用户关闭 Qoder，避免 Qoder 退出时覆盖 SQLite。
+- 写入前备份 `User/globalStorage/state.vscdb` 及同名 `-wal`、`-shm`。
+- 默认从 `C:\Users\<user>\.codex\config.toml` 读取 `model`、当前 `model_provider` 和对应 provider 的 `base_url`。
+- 默认从 `C:\Users\<user>\.codex\auth.json` 读取 `OPENAI_API_KEY`，用 Qoder `Local State` 的 Chromium OSCrypt key 加密后写入 `secret://aicoding.customModel.apiKey.<model_id>`。
+
+## 一步配置
+
+运行 bundled 脚本：
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File .agents\skills\qoder-codex-api-config\scripts\configure-qoder-codex-api.ps1
+```
+
+常用覆盖参数：
+
+```powershell
+powershell -NoProfile -ExecutionPolicy Bypass -File .agents\skills\qoder-codex-api-config\scripts\configure-qoder-codex-api.ps1 `
+  -Model "gpt-5.5" `
+  -BaseUrl "http://47.250.148.224" `
+  -Alias "Codex GPT-5.5" `
+  -Provider "openai" `
+  -ByokTypeKey "openai"
+```
+
+## 写入内容
+
+脚本会写入：
+
+- `aicoding.customModels`: Qoder custom model 数组
+- `secret://aicoding.customModel.apiKey.<model_id>`: 加密后的 API key
+- `chat.modelConfig.assistant`: `custom:<model_id>`
+- `chat.modelConfig.experts`: `custom:<model_id>`
+- `aicoding.aicoding-agent`: `globalstate-selected-models` 中的 chat/assistant
+- `__$__targetStorageMarker`: 补充相关 storage scope marker
+
+默认模型 ID 会从模型名生成，例如 `gpt-5.5` -> `model_codex_gpt_5_5`。
+
+## 验证
+
+配置后脚本会验证：
+
+- `aicoding.customModels` 是数组且包含目标模型
+- SecretStorage 记录可被当前 Windows 用户解密，且和 Codex API key 一致
+- 默认模型选择已写入
+
+如果 Qoder 启动后仍不显示该模型，优先检查：
+
+1. Qoder 是否在写入时仍在运行。
+2. Qoder 后端是否允许 BYOK，自定义模型功能可能受账号/远端开关控制。
+3. Qoder 实际 provider 是否接受 `Provider`/`ByokTypeKey`，默认使用 `openai`。
+4. Codex 当前 `wire_api` 可能是 `responses`，而 Qoder BYOK 后端可能只支持 provider 自身协议。

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/qoder-codex-api-config/agents/openai.yaml

@@ -1,7 +1,7 @@
-interface:
-  display_name: "Qoder Codex API Config"
-  short_description: "配置 Qoder 使用当前 Codex API"
-  default_prompt: "Use $qoder-codex-api-config to configure Qoder to use my current Codex API settings."
-
-policy:
-  allow_implicit_invocation: true
+interface:
+  display_name: "Qoder Codex API Config"
+  short_description: "配置 Qoder 使用当前 Codex API"
+  default_prompt: "Use $qoder-codex-api-config to configure Qoder to use my current Codex API settings."
+
+policy:
+  allow_implicit_invocation: true