@wwkit/harness 1.0.15 → 1.0.17

package/{agents/pyit.md → skills/pytest/SKILL.md}

@@ -1,47 +1,121 @@
 ---
+name: pytest
 description: |
-  Python 集成测试指挥官。协调模块适用性评估→环境检查→覆盖率分析→用例创建→测试执行→用例修复的完整流程。
-  最少 Mock，优先真实调用，目标覆盖率 70%。适用于 uv 管理的 Python 项目的集成测试自动化。
-  触发词：pyit、集成测试、integration test、集成测试覆盖率。
-mode: subagent
+  自包含 Python 测试 skill：合并原 pyut（单元测试）和 pyit（集成测试）。
+  通过 test_type=unit|integration 区分：unit 全 Mock 目标覆盖率 90%，integration 最少 Mock 目标覆盖率 70%。
+  协调适用性评估→环境检查→覆盖率分析→用例创建→测试执行→用例修复的完整流程，内外两层 loop。
+  调用方直接传原始任务消息，skill 自解析自包含。内部用 todowrite 管理 7 步。适用于 uv 管理的 Python 项目。
+license: MIT
+metadata:
+  workflow: sequential
 ---
 
-你是 Python 集成测试指挥官（pyit）。你负责协调一套完整的集成测试流程，确保目标模块的场景覆盖率和质量达到标准。
+# pytest 技能
 
-## 你的职责
+## 核心约束（最高优先级）
 
-1. 接收用户输入的源码路径和可选测试目录
-2. 调用 pytest-suitability-check 评估模块适用性，得到可测试类清单
-3. 调用 pytest-env-ensure 检查环境并加载配置
-4. 协调覆盖率分析 → 用例创建 → 测试执行 → 用例修复的内外两层 loop
-5. 管理 loop 次数和退出条件
-6. 输出最终测试质量报告并写入 `{report_dir}/test_report.md`
+- **MUST**：收到任务消息后，先 todowrite 落单 7 步，再逐步执行。
+- **MUST**：每步完成立即 todowrite 勾单。
+- **MUST**：test_type 只能是 unit 或 integration，其他值报错退出。
+- **禁止**：混合测试类型（unit 不混合 integration，反之亦然）。
+- **禁止**：修改 conftest.py（除非直接导致失败）。
 
-## 配置参数
+## 第一步硬指令（自检）
+
+解析入参前，强制自检：
+> 我是否已用 todowrite 落单 7 步？
+> - 未落单 → 立即 todowrite 创建清单。
+> - 已落单 → 继续。
+
+## 配置表（按 test_type 分支）
+
+| 维度 | unit | integration |
+|------|------|-------------|
+| coverage_threshold | 90 | 70 |
+| mock_strategy | full（全部 Mock 外部依赖） | minimal（最少 Mock，优先真实调用） |
+| test_dir 前缀 | tests/unit/ | tests/integration/ |
+| 适用性过滤 | 不过滤，所有类都适合 | 仅外部依赖类（Service/Integration Point/External Adapter），过滤 Pure Utility / Data Model |
+| 环境补充检查 | 无 | DB连接 / 外部服务连通性 / 测试数据目录（非阻断式警告） |
+| 环境依赖 | pytest, pytest-cov | pytest, pytest-cov, pytest-timeout |
+| pytest marker | unit | integration |
+| 覆盖率权重 | 行30 / 分支30 / 函数20 | 行20 / 分支20 / 函数10 |
+| 覆盖率阈值（行/分支/函数） | 90% / 70% / 90% | 70% / 50% / 70% |
+| 质量维度 | 断言完整性5 / 异常路径5 / 边界值5 / 命名规范5 | 场景完整性15 / 数据流验证10 / 断言完整性10 / fixture使用10 / 命名规范5 |
+| 特殊规则 | 不修改 conftest；不混合集成测试 | 按业务场景组织用例；不混合单元测试 |
+| 报告标题 | pytest unit 测试质量报告 | pytest integration 测试质量报告 |
+| 退出达标 | score ≥ 90 | score ≥ 70 |
+
+通用配置（两种 test_type 共享）：
 
-- test_type: **integration**
-- coverage_threshold: **70**（来自 config）
 - outer_max: **3**（外层 loop 最大轮次）
 - inner_max: **3**（内层 loop 最大轮次）
-- mock_strategy: **minimal**（最少 Mock，优先真实调用）
+- report 路径：`{test_dir}/reports/{YYYYMMDD_HHMMSS}/test_report.md`
+
+## 输入参数（自包含）
+
+入参为调用方传入的**原始任务消息**，可能是以下任一形态：
+
+- **JSON 对象**：`{test_type, source, test_dir}`，直接取字段值。
+- **key=value**：`test_type=unit, source=src/mymodule`，按 `,` 和 `=` 拆分为字段。
+- **纯文本 prose**：含 "集成/integration" → integration；含 "单元/unit" → unit；默认 unit。`source` 从文本中出现的路径推断。
+- **命令风格**：`unit src/mymodule` 或 `integration src/mymodule tests/integration/mymodule`，第一段为 test_type，第二段为 source，第三段（可选）为 test_dir。
+
+字段清单：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| test_type | string | 是 | `unit` 或 `integration`，其他值报错退出 |
+| source | string | 是 | 源码包目录或 .py 文件路径 |
+| test_dir | string | 否 | 测试目录；未指定时按 `tests/{test_type}/{归一化路径}/` 自动推导 |
+
+**必填校验**：若无法解析出 `test_type` 或 `source`，将错误信息输出到 stderr 并结束，**禁止**继续执行。
+
+**test_type 校验**：解析后若 `test_type` 不在 `{unit, integration}` 中，输出 "test_type 只能是 unit 或 integration，得到: {value}" 并结束。
+
+## 输出
+
+- 流程结束后将最终报告写入 `{report_dir}/test_report.md`，同时在 chat 中输出报告摘要。
+- 源码 Bug 汇总（若有）写入 `{report_dir}/bug_list.md`。
+- 中间产物（临时评分文件等）写入 `report_dir`，不污染源码目录。
 
 ## 工作流程
 
+### 阶段 0：todowrite 落单
+
+收到任务消息后，先用 `todowrite` 创建 7 步清单（status=pending）：
+
+1. 入参校验与目录映射（test_type + source + test_dir）
+2. 模块适用性评估
+3. 环境检查（+ integration 补充检查）
+4. 覆盖率分析（外层 loop）
+5. 用例创建
+6. 测试执行
+7. 用例修复（内层 loop）
+
+每步完成立即 todowrite 勾单（status=completed）。
+
 ### Step 1：入参校验与目录映射
 
-接收两个参数：`$1`（源码路径，必填）、`$2`（测试目录，可选）。
+将第 1 步标记为 in_progress，按"输入参数"小节解析原始任务消息，得到 `test_type`、`source`、`test_dir`。
 
-#### 参数1校验（源码路径）
+#### test_type 校验
 
 | 检查项 | 失败提示 |
 |--------|---------|
-| 为空 | "请提供源码路径，如 /pyit src/mymodule" |
+| 为空 | "请提供 test_type（unit 或 integration）" |
+| 非 unit/integration | "test_type 只能是 unit 或 integration，得到: {value}" |
+
+#### 参数 source 校验（源码路径）
+
+| 检查项 | 失败提示 |
+|--------|---------|
+| 为空 | "请提供源码路径，如 pytest src/mymodule（test_type=unit）" |
 | 不存在 | "路径不存在: {path}" |
 | 是 .py 文件 | 直接使用该文件作为 target（单文件测试模式） |
 | 是非 .py 文件 | "非 Python 文件: {path}" |
 | 是目录但无 .py 文件 | "目录下无 Python 文件: {path}" |
 
-#### 参数2校验（测试目录，可选）
+#### 参数 test_dir 校验（可选）
 
 | 条件 | 行为 |
 |------|------|
@@ -50,13 +124,20 @@ mode: subagent
 | 指定但非目录 | "测试路径不是目录: {path}" |
 | 合法 | 直接使用，跳过映射推导 |
 
-#### 目录映射规则（$2 未指定时自动推导）
+#### 目录映射规则（test_dir 未指定时自动推导）
 
-按 `references/config.md` 的"目录映射算法"执行，其中 `test_type = integration`。
+核心规则：`test_dir = tests/{test_type}/{归一化路径}/`，归一化仅去除 `src/` 前缀，保留包名。
 
-核心规则：`test_dir = tests/integration/{归一化路径}/`，归一化仅去除 `src/` 前缀，保留包名。
+**映射示例（unit）**：
 
-**映射示例**：
+| 源码路径 | 归一化 | 自动推导 test_dir |
+|---------|--------|------------------|
+| `src/pytest-sample` | `pytest-sample` | `tests/unit/pytest-sample/` |
+| `src/mypackage/sub` | `mypackage/sub` | `tests/unit/mypackage/sub/` |
+| `src/mypackage/MyService.py` | `mypackage` | `tests/unit/mypackage/` |
+| `mypackage/sub`（flat layout） | `mypackage/sub` | `tests/unit/mypackage/sub/` |
+
+**映射示例（integration）**：
 
 | 源码路径 | 归一化 | 自动推导 test_dir |
 |---------|--------|------------------|
@@ -69,10 +150,11 @@ mode: subagent
 #### 产出
 
 Step 1 结束后，确定以下变量，传递给后续所有 skill：
+
 - `target`：源码路径
 - `test_dir`：测试目录路径
 - `report_dir`：报告输出目录，格式为 `{test_dir}/reports/{YYYYMMDD_HHMMSS}/`
-- `test_type`：integration
+- `test_type`：unit 或 integration
 - `flow_start_time`：流程开始时间戳（执行 `date +%s` 获取）
 
 **报告目录规则**：
@@ -81,33 +163,48 @@ Step 1 结束后，确定以下变量，传递给后续所有 skill：
 
 **退出条件**：参数校验失败 → 直接退出，不进入后续流程。
 
+完成后 todowrite 勾单第 1 步。
+
 ### Step 2：模块适用性评估
 
 调用 **pytest-suitability-check** 技能，传入参数：
+
 - target: 源码包目录路径
-- test_type: integration
+- test_type: 当前 test_type
+
+**分支：test_type == unit**
+
+UT 理论上对所有类都适合，此步骤主要提供分类信息，**不做过滤**。所有类都进入 `testable_classes`。
+
+**分支：test_type == integration**
 
 IT 仅适合有外部依赖的类（Service Class / Integration Point / External Adapter），Pure Utility 和 Data Model 类将被过滤。
 
 **产出**：
+
 - `testable_classes`：可测试类清单（文件路径 + 类名 + 分类），传递给 Step 5
 
 **退出条件**：
+
 - 可测试清单非空 → 继续 Step 3，保存 `testable_classes` 供 Step 5 使用
 - 可测试清单为空 → 根据原因提示并终止：
   - 无 .py 文件 → "目录下无 Python 文件"
   - 有 .py 文件但无类定义 → "未发现类定义，仅有函数/模块级代码"
-  - 有类定义但全部被过滤（无外部依赖） → "未发现适合集成测试的类（需有外部依赖），建议改用 /pyut"
+  - 有类定义但全部被过滤（test_type=integration 无外部依赖） → "未发现适合集成测试的类（需有外部依赖），建议改用 test_type=unit"
+  - 有类定义但全部被跳过（test_type=unit） → "可测试类被全部跳过: {跳过原因}"
+
+完成后 todowrite 勾单第 2 步。
 
 ### Step 3：环境检查
 
 调用 **pytest-env-ensure** 技能：
+
 - 检查是否为 uv 项目
-- 检查并安装依赖（pytest, pytest-cov, pytest-timeout）
-- 检查 pytest marker 注册（unit, integration）
+- 检查并安装依赖（test_type=unit: pytest, pytest-cov；test_type=integration: pytest, pytest-cov, pytest-timeout）
+- test_type=integration 时：检查 pytest marker 注册（unit, integration）
 - 加载配置清单（references/config.md）
 
-**集成测试环境补充检查**（env-ensure 之后执行）：
+**分支：test_type == integration 的环境补充检查**（env-ensure 之后执行）
 
 | 检查项 | 方法 | 失败处理 |
 |--------|------|---------|
@@ -115,9 +212,18 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 | 外部服务连通性 | ping 源码中引用的外部服务地址 | 记录警告，提示对应服务不可用 |
 | 测试数据目录 | 检查 test_dir 是否存在，若存在则检查 fixtures/ 子目录 | test_dir 不存在则提示首轮会自动创建；fixtures/ 不存在则提示 case-create 会自动创建 |
 
-> 集成测试环境检查为**非阻断式**：记录警告但不退出流程。集成测试可能依赖运行时环境，agent 无法自动修复，仅提示用户。
+> 集成测试环境检查为**非阻断式**：记录警告但不退出流程。集成测试可能依赖运行时环境，skill 无法自动修复，仅提示用户。
 
-**退出条件**：env-ensure 失败 → 直接退出。集成环境警告 → 继续流程。
+**分支：test_type == unit**
+
+无补充检查。env-ensure 失败即退出。
+
+**退出条件**：
+
+- env-ensure 失败 → 直接退出，提示用户。
+- test_type=integration 的环境警告 → 继续流程（非阻断）。
+
+完成后 todowrite 勾单第 3 步。
 
 ### Step 4：覆盖率分析（外层 loop 开始）
 
@@ -137,7 +243,7 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 - target: 用户指定的模块路径
 - test_dir: 从 Step 1 确定的测试目录路径
 - report_dir: 从 Step 1 确定的报告输出目录
-- test_type: integration
+- test_type: 当前 test_type（unit 或 integration）
 - config: 从 Step 3 获得的配置
 - previous_score: round_start_score 值（首轮不传，由 coverage-analyze 自行处理 null）
 
@@ -147,17 +253,21 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 1. **轮首调用**（round 2+，或 round 1 有已有测试时）：用于识别未覆盖区域，供 Step 5 case-create 使用。将得到的 score 保存到 `round_start_score`，作为本轮改进比较的基准。**此调用不检查退出条件**。
 2. **轮尾调用**（所有 round）：在 case-create → execute → fix 完成后重新评分，与 `round_start_score` 比较判断是否有改进。**此调用检查所有退出条件**。
 
+设 `threshold = config[test_type].coverage_threshold`（unit=90, integration=70）。
+
 **退出条件**（仅在轮尾调用时检查）：
-- score ≥ 70 → 输出最终报告，流程结束
+- score ≥ threshold → 输出最终报告，流程结束
 - score ≤ round_start_score → 输出"无改进"报告，流程结束
-- score < 70 且 outer_round < 3 → 进入下一轮外层 loop（outer_round + 1）
-- score < 70 且 outer_round = 3 → 输出"超限"报告，流程结束
+- score < threshold 且 outer_round < 3 → 进入下一轮外层 loop（outer_round + 1）
+- score < threshold 且 outer_round = 3 → 输出"超限"报告，流程结束
 
 **轮首调用**（round 2+，或 round 1 有已有测试时）：
 - 获取 `uncovered_areas` 和 `score`，将 `score` 保存到 `round_start_score`（供轮尾比较）
 - 不检查退出条件
 - 直接进入 Step 5
 
+完成后 todowrite 勾单第 4 步。
+
 ### Step 5：用例创建
 
 调用 **pytest-case-create** 技能，传入参数：
@@ -165,22 +275,24 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 - testable_classes: 从 Step 2 获得的可测试类清单
 - target: 目标模块路径
 - test_dir: 从 Step 1 确定的测试目录路径
-- test_type: integration
+- test_type: 当前 test_type
 - config: 配置对象
 
-**注意**：mock_strategy=minimal，优先真实调用，仅 Mock 不可控的外部服务。该技能直接使用传入的 test_dir 扫描已有测试，增量追加不覆盖。
+**注意**：mock_strategy = config[test_type].mock_strategy（unit=full 全部 Mock，integration=minimal 最少 Mock）。该技能直接使用传入的 test_dir 扫描已有测试，增量追加不覆盖。
 
 **退出条件**：
 - 新增用例 > 0 → 进入 Step 6
 - 新增用例 = 0 → 跳过 Step 6+7，直接回到 Step 4 轮尾评分（轮尾 score 将等于 round_start_score，触发"无改进"退出）
 - uncovered_areas 为空 → 跳过 Step 6+7，直接回到 Step 4 轮尾评分
 
+完成后 todowrite 勾单第 5 步。
+
 ### Step 6：测试执行
 
 调用 **pytest-execute** 技能，传入参数：
 - target: 目标模块路径
 - test_dir: 从 Step 1 确定的测试目录路径
-- test_type: integration
+- test_type: 当前 test_type
 - config: 配置对象
 - test_files: Step 5 新创建的测试文件（可选）
 
@@ -188,13 +300,15 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 - 全部通过 → 回到 Step 4 轮尾评分（当前轮次，outer_round 递增在轮尾评分后发生）
 - 有失败 → 进入 Step 7
 
+完成后 todowrite 勾单第 6 步。
+
 ### Step 7：用例修复（内层 loop）
 
 调用 **pytest-case-fix** 技能，传入参数：
 - failed_tests: 从 Step 6 获得的失败用例清单
 - test_dir: 从 Step 1 确定的测试目录路径
 - report_dir: 从 Step 1 确定的报告输出目录
-- test_type: integration
+- test_type: 当前 test_type
 - config: 配置对象
 
 **退出条件**：
@@ -202,10 +316,14 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 - 无修复（全部标记人工处理）→ 内层 loop 退出，回到 Step 4 轮尾评分
 - inner_round ≥ 3 → 内层 loop 退出，回到 Step 4 轮尾评分
 
-**源码修改注意**：如果 case-fix 修改了源码文件，回到外层 loop 时 `testable_classes`（Step 2 产出）可能已过期。agent 应在状态快照中标记 `[STATE] source_modified=true`，并在外层 loop round 2+ 时提示"源码已修改，适用性清单可能过期"。
+**源码修改注意**：如果 case-fix 修改了源码文件，回到外层 loop 时 `testable_classes`（Step 2 产出）可能已过期。应在状态快照中标记 `[STATE] source_modified=true`，并在外层 loop round 2+ 时提示"源码已修改，适用性清单可能过期"。
+
+完成后 todowrite 勾单第 7 步。
 
 ## Loop 控制状态机
 
+设 `threshold = config[test_type].coverage_threshold`（unit=90, integration=70）。
+
 ```
 外层 loop (max 3):
   round 1: [首轮跳过 coverage-analyze] → case-create → execute → [fix → execute] → coverage-analyze(轮尾评分)
@@ -219,10 +337,10 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
   退出条件只在轮尾 coverage-analyze（case-create→execute→fix 完成后）检查。
 
 外层退出条件（仅轮尾 coverage-analyze 检查）:
-  - score ≥ 70 → 达标退出
+  - score ≥ threshold → 达标退出
   - score ≤ round_start_score → 无改进退出
-  - score < 70 且 outer_round = 3 → 超限退出
-  - score < 70 且 outer_round < 3 → outer_round + 1，进入下一轮
+  - score < threshold 且 outer_round = 3 → 超限退出
+  - score < threshold 且 outer_round < 3 → outer_round + 1，进入下一轮
 
 内层 loop (max 3):
   fix → execute → fix → execute → fix → execute
@@ -245,7 +363,7 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 
 | 变量 | 初始值 | 更新时机 |
 |------|--------|---------|
-| outer_round | 1 | 轮尾评分且 score < 70 且 outer_round < 3 时 → +1；轮首调用不递增 |
+| outer_round | 1 | 轮尾评分且 score < threshold 且 outer_round < 3 时 → +1；轮首调用不递增 |
 | inner_round | 0 | 内层 loop 每完成一轮 fix → +1；回到外层时重置为 0 |
 | round_start_score | 0 | 轮首 coverage-analyze 结束后更新（首轮跳过时保持 0）；轮尾调用时作为改进比较基准 |
 | new_cases_count | 0 | 每轮 case-create 结束后更新。若为 0 则跳过 execute+fix，直接进入轮尾评分 |
@@ -262,7 +380,7 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 ### 状态检查规则
 
 1. 进入 Step 4 时（轮首调用，round 2+ 或 round 1 有已有测试）：获取 `uncovered_areas` 和 `score`，将 `score` 保存到 `round_start_score`，**不检查退出条件**
-2. 进入 Step 4 时（轮尾调用，所有 round）：检查退出条件（score ≥ 70 / score ≤ round_start_score / outer_round = 3 且 score < 70），不更新 `round_start_score`（轮首已设置）
+2. 进入 Step 4 时（轮尾调用，所有 round）：检查退出条件（score ≥ threshold / score ≤ round_start_score / outer_round = 3 且 score < threshold），不更新 `round_start_score`（轮首已设置）
 3. 进入 Step 5 后：检查 `new_cases_count == 0` → 跳过 execute+fix，直接回到 Step 4 轮尾评分
 4. 进入 Step 7 前：检查 `inner_round ≥ 3` → 内层超限，回到外层（轮尾评分）
 5. 每个报告中的"各轮得分变化"表必须基于状态变量填写，不可凭记忆
@@ -270,24 +388,24 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 
 ## 最终报告格式
 
-流程结束后，输出最终报告：
+流程结束后，输出最终报告（`test_type_label` = unit→"单元", integration→"集成"）：
 
 ```
 > 生成时间: {YYYY-MM-DD HH:MM:SS}
-> 测试类型: integration
+> 测试类型: {test_type}
 > 测试目录: {test_dir}
 
-## pyit 集成测试质量报告
+## pytest {test_type} 测试质量报告
 
 ### 环境信息
 - 项目类型: uv 项目 ✓
 - 依赖检查: 全部通过 ✓
-- 测试类型: integration
-- Mock 策略: minimal
+- 测试类型: {test_type}
+- Mock 策略: {config[test_type].mock_strategy}
 
 ### 最终结果
 - 得分: XX / 100（等级: X）
-- 覆盖率阈值: 70
+- 覆盖率阈值: {threshold}
 - 外层迭代: X / 3
 - 是否达标: [是/否]
 - 总耗时: Xs
@@ -309,15 +427,42 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 |------|------|------|---------|----------|------|
 | 1 | XX | X | X | X/X | Xs |
 | 2 | XX | X | X | X/X | Xs |
+```
+
+**覆盖率明细**（权重按配置表）：
+
+unit:
+```
+| 维度 | 实际 | 阈值 | 权重 | 得分 |
+|------|------|------|------|------|
+| 行覆盖率 | XX% | 90% | 30 | XX |
+| 分支覆盖率 | XX% | 70% | 30 | XX |
+| 函数覆盖率 | XX% | 90% | 20 | XX |
+```
 
-### 覆盖率明细
+integration:
+```
 | 维度 | 实际 | 阈值 | 权重 | 得分 |
 |------|------|------|------|------|
 | 行覆盖率 | XX% | 70% | 20 | XX |
 | 分支覆盖率 | XX% | 50% | 20 | XX |
 | 函数覆盖率 | XX% | 70% | 10 | XX |
+```
 
-### 质量明细
+**质量明细**（维度按配置表）：
+
+unit:
+```
+| 维度 | 达标/应测 | 权重 | 得分 |
+|------|----------|------|------|
+| 断言完整性 | X/X | 5 | X |
+| 异常路径覆盖 | X/X | 5 | X |
+| 输界值覆盖 | X/X | 5 | X |
+| 命名规范 | X/X | 5 | X |
+```
+
+integration:
+```
 | 维度 | 达标/应测 | 权重 | 得分 |
 |------|----------|------|------|
 | 场景完整性 | X/X | 15 | X |
@@ -325,7 +470,9 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 | 断言完整性 | X/X | 10 | X |
 | fixture 使用 | X/X | 10 | X |
 | 命名规范 | X/X | 5 | X |
+```
 
+```
 ### 未解决项（如有）
 - [ ] xxx: [原因]
 
@@ -335,12 +482,11 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 | # | 源码文件 | 方法 | Bug 描述 | 状态 | 修复内容/原因 |
 |---|---------|------|---------|------|-------------|
 | 1 | MyService.py | create | 返回值逻辑错误 | 已修复 | 修正返回值 |
-| 2 | OrderService.py | create_order | 类型校验缺失 | 需人工处理 | 需业务确认预期行为 |
 
 ### 退出原因
-- [达标] score ≥ 70
+- [达标] score ≥ {threshold}
 - [无改进] score ≤ round_start_score（本轮无改进）
-- [超限] outer_round = 3 且 score < 70
+- [超限] outer_round = 3 且 score < {threshold}
 ```
 
 ### 报告输出
@@ -352,10 +498,23 @@ IT 仅适合有外部依赖的类（Service Class / Integration Point / External
 
 ## 规则
 
-1. 只处理 tests/integration/ 目录下的测试
-2. 最少 Mock，优先真实调用（仅 Mock 不可控的生产 API）
-3. 按业务场景组织用例，不按函数
-4. 验证端到端数据流完整性
-5. 遵循 AGENTS.md：2 空格缩进、类格式、文件名=类名
-6. 测试命名：test_ 前缀（文件名和类名一致）
-7. 不混合单元测试
+**共同规则**：
+1. 只处理 `tests/{test_type}/` 目录下的测试
+2. 遵循 AGENTS.md：2 空格缩进、类格式、文件名=类名
+3. 测试命名：test_ 前缀（文件名和类名一致）
+4. 不混合测试类型（unit 不混合 integration，反之亦然）
+
+**unit 专属规则**：
+- 全部 Mock 外部依赖（HTTP/DB/文件/时间/随机/外部服务）
+- 不修改 conftest.py（除非直接导致失败）
+
+**integration 专属规则**：
+- 最少 Mock，优先真实调用（仅 Mock 不可控的生产 API）
+- 按业务场景组织用例，不按函数
+- 验证端到端数据流完整性
+
+## 工具使用约束
+
+- 写文件一律用 `write` 工具；读文件用 `read` 工具。
+- 需要中间数据时，用 `write` 工具写入临时文件，再以 stdin 重定向传给 node。
+- 禁止使用未授权的 `cp`/`rm`/`mv` 等命令；需要复制、移动或删除临时文件时，一律用允许的 `node -e` 的 fs 模块完成。

package/skills/pytest-env-ensure/references/config.md

@@ -68,9 +68,9 @@
 | fixture_file.name | conftest.py | 共享 fixture 文件名 |
 | fixture_file.data_dir | fixtures | 测试数据目录名 |
 
-### 目录映射算法（pyut/pyit agent Step 1 唯一权威定义）
+### 目录映射算法（pytest skill Step 1 唯一权威定义）
 
-> pyut/pyit agent 的 Step 1 直接引用本算法，不另行重复定义。
+> pytest skill 的 Step 1 直接引用本算法，不另行重复定义。
 
 当用户未显式指定测试目录时，agent 按以下步骤自动推导 `test_dir`：
 

package/skills/pytest-sample/SKILL.md

@@ -4,7 +4,7 @@ description: |
   在当前工程 src/ 下创建 pytest-sample 目录，注入一批 demo 类代码。
   覆盖纯函数、HTTP Mock、DB Mock、文件系统、时间依赖、随机值、环境变量、状态机等多种测试场景。
   demo 代码中故意注入了 15 个 bug（分 3 个难度梯度），用于触发测试代理的 create→test→fix 循环。
-  适用：首次使用 pyut/pyit agent 前的演示验证、测试 agent 流程的端到端测试。
+  适用：首次使用 pytest skill 前的演示验证、测试流程的端到端测试。
   不适用：生产代码、非测试目的的代码生成。
 ---
 
@@ -130,8 +130,8 @@ demo 代码中故意注入了 15 个 bug，分为 3 个难度梯度，用于尽
 - 总计: 15 个
 
 ### 使用方式
-1. 单元测试: /pyut src/pytest-sample
-2. 集成测试: /pyit src/pytest-sample
+1. 单元测试: /pytest unit src/pytest-sample
+2. 集成测试: /pytest integration src/pytest-sample
 
 ### 场景覆盖说明
 - 纯函数测试: Calculator.add, Calculator.is_prime

package/skills/read-docs/references/superpowers/comparison.md

@@ -7,7 +7,7 @@
 | **编排者** | 宿主内置 agent + 技能 prompt | 自定义 `work` agent（`mode: primary`） |
 | **编排指令来源** | `using-superpowers` bootstrap + 技能 | agent 定义文件本身 |
 | **Worker** | 宿主内置 `general-purpose` | 宿主内置 `explore` / `general` |
-| **自定义 agent** | 无 | 7 个（work/extract/revise/query/lint/pyit/pyut） |
+| **自定义 agent** | 无 | 3 个（work/query/lint） |
 | **技能系统** | 14 个技能，通过 `skill` 工具加载 | harness 自己的技能系统 |
 | **平台** | 跨平台（11+ harness） | 仅 opencode |
 

package/skills/read-docs/references/superpowers/index.md

@@ -44,7 +44,7 @@ Superpowers 是一个跨平台的 coding agent 增强插件，通过 **skills（
 |------|------------|-------------------|
 | 编排者 | 宿主内置 agent + 技能 prompt | 自定义 `work` agent（`mode: primary`） |
 | Worker | 宿主内置 `general-purpose` | 宿主内置 `explore` / `general` |
-| 自定义 agent | 无 | 7 个（work/extract/revise/query/lint/pyit/pyut） |
+| 自定义 agent | 无 | 3 个（work/query/lint） |
 | 平台 | 跨平台（11+ harness） | 仅 opencode |
 
 ## 模块索引