@wwkit/harness 1.0.27 → 1.0.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/harness",
-  "version": "1.0.27",
+  "version": "1.0.28",
   "author": "bluesliu <langcai163@163.com>",
   "description": "WebWork abilities for opencode",
   "type": "module",

package/skills/pytest/SKILL.md

@@ -11,23 +11,26 @@ metadata:
   workflow: sequential
 ---
 
-# pytest 技能
+# pytest 技能（固定 Sprint 冲刺）
 
-## 核心约束（最高优先级）
+## 执行范式
 
-- **MUST**：收到任务消息后，先 todowrite 落单 7 步，再逐步执行。
-- **MUST**：每步完成立即 todowrite 勾单。
-- **MUST**：test_type 只能是 unit、integration 或 sample，其他值报错退出。
-- **禁止**：混合测试类型（unit 不混合 integration，反之亦然）。
-- **禁止**：修改 conftest.py（除非直接导致失败）。
-- **MUST**：子工作流通过 `read` 加载 `references/xxx.md` 并按其指令执行，**不再调用独立 skill**（原 pytest-* 子 skill 已合并入 references/）。
+每次调用 = 一个固定 Sprint，三个事件：
+
+1. **Sprint Planning**：解析入参 → 定义 Sprint Goal → todowrite 落固定 7 项 Sprint Backlog（每项带 DoD）
+2. **Sprint Execution**：7 步 + 双层 loop 逐项执行，每项 = 执行 → 验证 DoD → todowrite 勾单 Done
+3. **Sprint Review**：对照 Sprint Goal 验证 Increment（测试报告）及输出语义，沉淀 1 条回顾
 
-## 第一步硬指令（自检）
+**Sprint Goal** = `对 {{source}} 执行 {{test_type}} 测试，产出测试质量报告（unit 达标 score≥90，integration 达标 score≥70）`。
 
-解析入参前，强制自检：
-> 我是否已用 todowrite 落单 7 步？
-> - 未落单 → 立即 todowrite 创建清单。
-> - 已落单 → 继续。
+**铁律（最高优先级）：**
+
+- **没有 Sprint Backlog 不能开始执行**：收到任务消息后，先做 Sprint Planning（解析入参）再 todowrite 落固定 7 项 Sprint Backlog，然后才进入 Sprint Execution。
+- **每项执行周期** = 进度检查（Daily Scrum 映射）→ 执行 → 验证 DoD → 勾单 Done。
+- **子工作流通过 `read` 加载 `references/xxx.md` 并按其指令执行**，**不再调用独立 skill**（原 pytest-* 子 skill 已合并入 references/）。
+- **禁止**：混合测试类型（unit 不混合 integration，反之亦然）。
+- **禁止**：修改 conftest.py（除非直接导致失败）。
+- **禁止**：使用 WebFetch 或任何网络请求。
 
 ## 配置表（按 test_type 分支）
 
@@ -57,14 +60,7 @@ metadata:
 
 ## 输入参数（自包含）
 
-入参为调用方传入的**原始任务消息**，可能是以下任一形态：
-
-- **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。
-
-字段清单：
+入参为调用方传入的**原始任务消息**，可为 JSON 对象、key=value、自然语言或命令风格等任意形态，agent 依据字段语义自主提取（详见 Step 1）。字段清单：
 
 | 字段 | 类型 | 必填 | 说明 |
 |------|------|------|------|
@@ -72,6 +68,8 @@ metadata:
 | source | string | 是 | 源码包目录或 .py 文件路径 |
 | test_dir | string | 否 | 测试目录；未指定时按 `tests/{test_type}/{归一化路径}/` 自动推导 |
 
+**提取原则**：从消息中自主识别三个字段——命令风格（`unit src/mymodule` 或 `integration src/mymodule tests/integration/mymodule`，第一段为 test_type，第二段为 source，第三段可选为 test_dir）、JSON 对象（`{test_type, source, test_dir}`）、key=value（`test_type=..., source=...`）、或自然语言（含 "集成/integration" → integration；含 "单元/unit" → unit；默认 unit；`source` 从出现的路径推断）。
+
 **必填校验**：若无法解析出 `test_type` 或 `source`，将错误信息输出到 stderr 并结束，**禁止**继续执行。
 
 **test_type 校验**：解析后若 `test_type` 不在 `{unit, integration, sample}` 中，输出 "test_type 只能是 unit、integration 或 sample，得到: {value}" 并结束。
@@ -84,17 +82,19 @@ metadata:
 
 ## 工作流程
 
-### 阶段 0：todowrite 落单
+### 阶段 0：todowrite 落单（Sprint Backlog）
 
-收到任务消息后，先用 `todowrite` 创建 7 步清单（status=pending）：
+收到任务消息后，先用 `todowrite` 创建固定 7 项 Sprint Backlog（status=pending），每项带 DoD：
 
-1. 入参校验与目录映射（test_type + source + test_dir）
-2. 模块适用性评估
-3. 环境检查（+ integration 补充检查）
-4. 覆盖率分析（外层 loop）
-5. 用例创建
-6. 测试执行
-7. 用例修复（内层 loop）
+| # | 任务 | 对应 Step | DoD |
+|---|------|----------|-----|
+| 1 | 入参校验与目录映射 | Step 1 | test_type/source/test_dir 已校验，target/test_dir/report_dir/flow_start_time 已确定，7 项清单已建 |
+| 2 | 模块适用性评估 | Step 2 | 得到 testable_classes（或为空已按原因退出） |
+| 3 | 环境检查 | Step 3 | 得到 config（或 env-ensure 失败已退出）；integration 补充检查已记录警告 |
+| 4 | 覆盖率分析（外层 loop） | Step 4 | 得到 score/uncovered_areas，按退出条件结束或进入下一轮 |
+| 5 | 用例创建 | Step 5 | 得到 new_cases_count（=0 已跳过 execute+fix 直接轮尾评分） |
+| 6 | 测试执行 | Step 6 | 得到通过/失败结果（有失败已进入 Step 7） |
+| 7 | 用例修复（内层 loop） | Step 7 | 得到修复结果，按内层退出条件回到 Step 6 或 Step 4 轮尾评分 |
 
 每步完成立即 todowrite 勾单（status=completed）。
 
@@ -502,6 +502,14 @@ integration:
 - 内容：上述完整报告（含源码 Bug 汇总）
 - 同时在 chat 中输出报告摘要
 
+## Sprint Review
+
+所有 Backlog Items 完成后：
+
+- **对照 Sprint Goal 验证**：是否对 `{{source}}` 完成 `{{test_type}}` 测试并产出测试质量报告？得分是否达标（unit≥90，integration≥70）？报告是否写入 `report_dir/test_report.md`？
+- **展示 Increment**：测试报告路径 + chat 摘要。
+- **简要回顾（Retrospective）**：沉淀 1 条改进项供下一轮采纳。
+
 ## 规则
 
 **共同规则**：