@guanlin4924/devflow-pi 0.1.18 → 0.1.20

package/plugins/devflow-quality/skills/workflow-run-acceptance-tests/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: workflow-run-acceptance-tests
+description: "Execute the frozen TC acceptance suite after code review. Use the requirement baseline and frozen TC nodes for test intent; use current code only to bind execution adapters."
+---
+
+# 冻结验收测试执行
+
+此步骤在代码审查后、UAT 前运行。它的目标是执行冻结的 `TC-*`，而不是根据交付总结重新猜测要测什么。
+
+## 输入边界
+
+测试意图只能读取：
+
+- `.planning/requirements/{feature}/tests.json` 中已冻结且未 stale 的 `TC-*`；
+- 图谱中被 TC 引用的已确认 REQ / BR / BC / AC、契约与架构风险；
+- 初始化发现的测试工具链能力。
+
+可以读取当前源码和代码索引，但**仅**用来绑定入口、选择器、请求地址、测试数据与命令适配器。
+
+禁止读取或使用以下内容来扩大、缩小或补造验收范围：
+
+- `.planning/phases/{phase}/SUMMARY.md`；
+- agent 的交付自述、代码 diff 或“已完成”结论；
+- 未冻结的临时需求列表。
+
+## 过程
+
+1. 用 `devflow_acceptance_tests(feature)` 检查测试集已由 CP-3 冻结。若有 stale 或候选 TC，停止并回到需求/测试设计。
+2. 读取冻结 TC 与其 oracle、前置数据、身份和自动化模式。
+   对 `api_refs`、`workload_refs` 和 `risk_refs` 指向的专项用例，保留其契约、性能/迁移或韧性义务；没有适配器或环境时必须写为 blocked，不能用普通主流程替代。
+3. 读取代码审查报告、代码索引和实际源码，仅为每个 TC 绑定运行适配器；不得改变 TC 的断言、范围或预期。
+4. 写入 `.planning/features/{feature}/acceptance-test-bindings.json`：
+   - 固定 `test_suite.graph_revision` 与 `fingerprint`；
+   - 每个 TC 恰好一条绑定；
+   - `mode` 必须与冻结 TC 的 `automation_mode` 一致；
+   - 通用自动化用例使用 `{ "kind": "command", "argv": [ ... ] }`，不使用 shell 字符串；
+   - Core 生成的 API TC 可直接使用 `{ "kind": "http", "base_url_env": "DEVFLOW_TEST_BASE_URL", "headers_env": { "Authorization": "DEVFLOW_TEST_AUTHORIZATION" } }`。请求、HTTP 状态和异常码断言来自冻结 TC 的 `execution`，绑定只能提供环境地址和鉴权，不得重写测试意图；若场景需要专用夹具，可额外配置 `{ "setup": { "argv": [ ... ] } }`，Core 会先记录并执行该受控命令，再发 HTTP 请求；
+   - 人工或环境阻塞用例必须有 owner 与原因/阻塞源。
+5. 调用 `devflow_run_acceptance_tests(action="validate", feature=...)`。不通过时修正绑定，不得绕过。
+6. 调用 `devflow_run_acceptance_tests(action="run", feature=...)`。该 Core 工具记录每个 TC 的命令哈希、退出码和输出摘要。
+7. 失败、未执行或 blocked 的 TC 只能报告为 `blocked`/`failed`，不得在 CP-4 或 UAT 中宣称验收通过。
+
+## 输出
+
+- `.planning/features/{feature}/acceptance-test-bindings.json`
+- `.planning/test-runs/{feature}/acceptance-results.json`
+
+`acceptance-results.json` 是 Core-owned 的执行事实；Markdown 结论不能替代它。

package/plugins/devflow-quality/skills/workflow-run-acceptance-tests/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Run Frozen Acceptance Tests"
+  short_description: "执行冻结 TC 验收测试"
+  default_prompt: "基于冻结的 TC-* 绑定并执行验收测试；源码只能用于运行适配，不能改变测试意图。"

package/plugins/devflow-quality/skills/workflow-verify-work/SKILL.md

@@ -72,18 +72,24 @@ Verification must include these gates when project artifacts exist:
    - Run or require the commands declared by `.planning/toolchain.md`, `.planning/execution-contract.md`, `.context/workflow/verification.md`, or the change list.
    - Include target tests, full tests, build, codegen/mock/DI checks, migration checks, and integration tests when applicable.
 
-5. **Compatibility gate**
+5. **冻结验收测试门禁**
+   - 读取 `.planning/requirements/{feature}/tests.json`、`.planning/features/{feature}/acceptance-test-bindings.json` 和 `.planning/test-runs/{feature}/acceptance-results.json`。
+   - 调用 `devflow_run_acceptance_tests(action="validate_results", feature=...)`；它验证结果仍引用当前冻结 suite，且每个 `TC-*` 都已通过。
+   - 任一 TC 未执行、失败、人工待执行或因环境阻塞时，验证状态只能是 `blocked` 或 `failed`，CP-4 不得宣称验收通过。
+   - Markdown、UAT 口述或 agent 自述不能替代该 Core-owned 结果。
+
+6. **Compatibility gate**
    - Check interface, database, config, data migration, permission, and consumer compatibility risks.
    - For frontend-visible API/VO/schema changes, record backward compatibility or migration handling.
    - For database/model/config changes, record migration, rollback, and deployment ordering risk.
    - Record accepted residual risks explicitly.
 
-6. **Baseline decision gate**
+7. **Baseline decision gate**
    - Compare implementation against `.planning/requirements/baseline.md`, especially `反向审视与用户拍板`, `待确认事项`, and `下游输入契约`.
    - Confirm implemented behavior maps to `FP-*`, `BR-*`, `BC-*`, and confirmed `CR-*` decisions.
    - Any implemented scope based on a pending decision is a verification failure unless the user explicitly approved it.
 
-7. **Lessons extraction gate**
+8. **Lessons extraction gate**
    - After verification is complete, review the findings for lessons worth preserving.
    - Candidate triggers for a lesson:
      - A regression was caught early — what pattern prevented it?