@givolt/i3-composer-agent 2.3.6 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/plugins/marketplace.json +1 -1
- package/.claude/commands/i3-sop.md +19 -0
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +2 -2
- package/.gemini/commands/i3-sop.toml +19 -0
- package/README.md +37 -3
- package/commands/i3-sop.toml +19 -0
- package/docs/codebuddy-setup.md +3 -3
- package/docs/codex-setup.md +2 -2
- package/docs/other-hosts.md +2 -2
- package/docs/workbuddy-setup.md +3 -3
- package/evals/cases/i3-enterprise-sop.json +64 -0
- package/evals/fixtures/i3-enterprise-sop/brief.md +11 -0
- package/evals/zh-CN/cases/i3-enterprise-sop.json +61 -0
- package/hooks/PROTOTYPE.md +6 -2
- package/package.json +7 -1
- package/plugin.json +1 -1
- package/references/engineering-skeleton-resources/README.md +52 -0
- package/references/engineering-skeleton-resources/adoption.md +200 -0
- package/references/engineering-skeleton-resources/catalog.json +17 -0
- package/references/engineering-skeleton-resources/directory-standard.md +119 -0
- package/references/enterprise-sop-resources/README.md +165 -0
- package/references/enterprise-sop-resources/ad/README.md +70 -0
- package/references/enterprise-sop-resources/ad/assets-manifest.json +106 -0
- package/references/enterprise-sop-resources/ad/prompts/01-generate.md +58 -0
- package/references/enterprise-sop-resources/ad/prompts/02-review.md +54 -0
- package/references/enterprise-sop-resources/ad/prompts/03-revise.md +54 -0
- package/references/enterprise-sop-resources/ad/prompts/04-recheck.md +54 -0
- package/references/enterprise-sop-resources/ad/templates/AD.md +337 -0
- package/references/enterprise-sop-resources/assets-manifest.json +199 -0
- package/references/enterprise-sop-resources/brd/README.md +50 -0
- package/references/enterprise-sop-resources/brd/assets-manifest.json +94 -0
- package/references/enterprise-sop-resources/brd/prompts/01-generate.md +51 -0
- package/references/enterprise-sop-resources/brd/prompts/02-review.md +47 -0
- package/references/enterprise-sop-resources/brd/prompts/03-revise.md +47 -0
- package/references/enterprise-sop-resources/brd/prompts/04-recheck.md +47 -0
- package/references/enterprise-sop-resources/brd/templates/BRD.md +169 -0
- package/references/enterprise-sop-resources/codebuddy-project-guide.md +34 -0
- package/references/enterprise-sop-resources/controlled-handoff.md +41 -0
- package/references/enterprise-sop-resources/controlled_handoff.py +334 -0
- package/references/enterprise-sop-resources/handoff-contract.md +196 -0
- package/references/enterprise-sop-resources/handoff.py +277 -0
- package/references/enterprise-sop-resources/lifecycle-contract.md +91 -0
- package/references/enterprise-sop-resources/plan-handoff.md +73 -0
- package/references/enterprise-sop-resources/prd/README.md +137 -0
- package/references/enterprise-sop-resources/prd/assets-manifest.json +115 -0
- package/references/enterprise-sop-resources/prd/prompts/01-generate.md +64 -0
- package/references/enterprise-sop-resources/prd/prompts/02-review.md +49 -0
- package/references/enterprise-sop-resources/prd/prompts/03-revise.md +48 -0
- package/references/enterprise-sop-resources/prd/prompts/04-recheck.md +47 -0
- package/references/enterprise-sop-resources/prd/template-contracts.md +39 -0
- package/references/enterprise-sop-resources/prd/templates/AD.md +17 -0
- package/references/enterprise-sop-resources/prd/templates/PRD.md +257 -0
- package/references/enterprise-sop-resources/recovery-contract.md +65 -0
- package/references/enterprise-sop-resources/review-handoff.md +105 -0
- package/references/enterprise-sop-resources/selection-handoff.md +55 -0
- package/references/enterprise-sop-resources/selection_handoff.py +225 -0
- package/references/enterprise-sop-resources/stages.json +262 -0
- package/references/enterprise-sop-resources/technical-baseline/README.md +132 -0
- package/references/enterprise-sop-resources/technical-baseline/assets-manifest.json +101 -0
- package/references/enterprise-sop-resources/technical-baseline/baselines/PROVENANCE.md +40 -0
- package/references/enterprise-sop-resources/technical-baseline/baselines//344/274/201/344/270/232/345/272/224/347/224/250-/346/212/200/346/234/257/350/247/204/347/272/246_v0.0.2.md +295 -0
- package/references/enterprise-sop-resources/technical-baseline/references/engineering-directory-v0.2.0/adoption.md +112 -0
- package/references/enterprise-sop-resources/technical-baseline/references/engineering-directory-v0.2.0/directory-standard.md +119 -0
- package/references/enterprise-sop-resources/technical-baseline/templates/TECHNICAL-BASELINE.md +133 -0
- package/references/enterprise-sop-resources/template-contracts.md +142 -0
- package/references/enterprise-sop-resources/testcase/README.md +61 -0
- package/references/enterprise-sop-resources/testcase/assets-manifest.json +111 -0
- package/references/enterprise-sop-resources/testcase/prompts/01-generate.md +53 -0
- package/references/enterprise-sop-resources/testcase/prompts/02-review.md +51 -0
- package/references/enterprise-sop-resources/testcase/prompts/03-revise.md +49 -0
- package/references/enterprise-sop-resources/testcase/prompts/04-recheck.md +51 -0
- package/references/enterprise-sop-resources/testcase/templates/TestCase.md +269 -0
- package/references/enterprise-sop-resources/verification/README.md +149 -0
- package/references/enterprise-sop-resources/verification/check_execution.py +185 -0
- package/references/enterprise-sop-resources/verification/check_native_execution.py +282 -0
- package/references/enterprise-sop-resources/verification/check_reads.py +348 -0
- package/references/enterprise-sop-resources/verification/review-output.schema.json +155 -0
- package/references/enterprise-sop-resources/verification/review_handoff.py +329 -0
- package/scripts/ui-prototype-buddy-lifecycle-test.js +10 -5
- package/scripts/ui-prototype-codebuddy-hook-test.js +6 -0
- package/scripts/ui-prototype-recovery-test.js +11 -2
- package/skills/i3-enterprise-sop/SKILL.md +173 -0
- package/skills/i3-enterprise-sop/agents/openai.yaml +2 -0
- package/skills/i3-ui-prototype/SKILL.md +1 -1
- package/skills/i3-ui-prototype/references/execution-evidence.md +2 -2
- package/skills/i3-ui-prototype/scripts/codebuddy-context.cjs +18 -1
- package/skills/i3-ui-prototype/scripts/codebuddy-hook.cjs +27 -29
- package/skills/i3-ui-prototype/scripts/execution-diagnostics.cjs +24 -27
- package/skills/i3-ui-prototype/scripts/execution-gates.cjs +2 -3
- package/skills/i3-ui-prototype/scripts/execution-recovery.cjs +5 -5
- package/skills/i3-ui-prototype/scripts/execution-runtime.cjs +1 -2
- package/skills/i3-ui-prototype/scripts/native-command.cjs +1 -1
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# TestCase 候选生成任务
|
|
2
|
+
|
|
3
|
+
<!-- i3:zh-guide:start -->
|
|
4
|
+
## 中文使用说明
|
|
5
|
+
|
|
6
|
+
按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
|
|
7
|
+
|
|
8
|
+
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
|
+
<!-- i3:zh-guide:end -->
|
|
10
|
+
|
|
11
|
+
原方法调用:本次起草必须先成功加载原 `i3-spec-driven-development` Skill;宿主支持Skill工具时取得成功回执,再按其外部格式/存储能力使用本模板和唯一目标。不是调用原/i3-spec包装后改写其根SPEC.md规则,也不让using把Spec变成可选。方法不可用或真实冲突时报告,不裸跑写稿;内容、认可、保存后停轮保留。
|
|
12
|
+
|
|
13
|
+
目录与上下文:新项目无已采用输出约定时默认 `spec/{能力名称}/`,同PBC多主题PRD独立版本,AD/TestCase固定本次直接上游;已有位置不自动迁移。只读本主题完整来源及必要共享依赖,不全量载入候选/历史,摘要不替代正文。最后回读后原方法要求立即停轮时,报告候选实际路径和待登记事项,后续获准作业补JSON,不自动调用Plan/Build。
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
仅在本轮明确企业作业或适用的真实项目选择下使用,标准流程优先保留。实际读项目规则、根README及引用的采用/输出约定,从本轮材料→项目采用副本→同宿主项目安装→可读全局安装定位。读取选定阶段清单、模板、作业提示词及共用合同,选定源失效不换新版/其他宿主。模型整理任务卡,用户不必逐项填路径;真实歧义、冲突或覆盖风险才问。
|
|
18
|
+
|
|
19
|
+
内部任务卡包括实际项目根/宿主、阶段与动作、EBC或PBC/主题身份、精确业务来源/版本/条目、模板与提示词/本地修改、唯一展开目标/版本/现稿、允许写入及停点、假设/Q和影响范围。没有计算摘要如实写,不填假SHA,目录或作者摘要不证明已读。
|
|
20
|
+
|
|
21
|
+
## 本阶段内容核对
|
|
22
|
+
|
|
23
|
+
- §0.2、§6.1按路径、正文版本和条款固定本主题及必要关联组合;公共规范、共享契约/数据权威、提供消费AD、代码/服务/环境版本分别表达,不取最大版本、不强制同号或SHA256,不跨对象比较版本。
|
|
24
|
+
- §3.3、§6.2核唯一业务状态/写入责任、可信租户和主体作用域、幂等重放与新请求的校验顺序、严格消费者及快照过期;产品预期直接核PRD,不复制AD遗漏,不自造正式业务决定。
|
|
25
|
+
- §6.2—§6.4覆盖真实交接、拒绝/失败/UNKNOWN/重复/并发、回执查询、部分成功和恢复;核旧新组合、存量迁移/备份/不可逆限制、必要传递影响及既有行为回归,无关主题不机械改写/升版。
|
|
26
|
+
- §7.1中TestCase是Plan的可选输入:需求、技术约束与验证要求足够即可规划,已有则读取,没有则安排补齐设计;未定判据只限制依赖任务,不取消SPEC六项、必要人审或执行前检查。
|
|
27
|
+
- §0.2明确原test及Build复用TDD,可写测试和实现,不是只读文档生成;原代码review保留五维与临时变异验证,不整体套作零写入的文档review/recheck。本资源不实现JSON登记接点,不自动调用原入口或下阶段。
|
|
28
|
+
- §8.1只定义未来报告的准确组合、实际候选/环境/数据、逐项结果、副作用与证据;替身不关闭必需真实集成,未运行不造runId成功/通过率,实际脚本、Plan、锁和工程未形成不登记未来路径。
|
|
29
|
+
- 原型按需且可与AD并行;保留人工修改、原报告、业务Q、有据不采纳和明确委托修订;文档审查通过不替代代码审查或业务/发布认可。
|
|
30
|
+
|
|
31
|
+
## 执行与结束
|
|
32
|
+
|
|
33
|
+
1. 实际读选定来源和模板,写前列假设/推导/建议、准确来源与影响,未知列Q;保留原方法澄清、内容、边界认可和实际停轮,不虚构业务事实。
|
|
34
|
+
2. 只写展开后的唯一目标。目标已存在先读,明确修订/新版本及旧稿保留,不覆盖人工内容,不改上游/模板/提示词/其他主题。入口真冲突报告受阻范围,不写影子SPEC绕过。
|
|
35
|
+
3. 按完整模板写本次有效范围,保留来源、稳定需求/AC及受阻项,不把图/示例/候选写成已批准或已实现。
|
|
36
|
+
4. 跨位置核权限/状态/字段、拒绝/失败/未知和副作用;最终新增要求逐条回源,全文表格逐行核列数和列义。最后Edit/Write后分段完整Read最终目标及相关引用,再改则重新完整回读。
|
|
37
|
+
5. 汇报唯一输出、身份版本、实际读取、假设/Q、自查和未执行事项,交人工审阅后结束本轮。不自动审查/修订、下阶段、Plan、Build、实际测试或发布。
|
|
38
|
+
|
|
39
|
+
## B05 生命周期与必要读取
|
|
40
|
+
|
|
41
|
+
按选定资源索引实际读lifecycleContract及共用模板/交接合同;先列本次必读路径和用途,实际核所选正文及必要依赖,未读/失败/部分读照实。只加载本次generate动作,不加载其他动作或低优先级源兜底。
|
|
42
|
+
|
|
43
|
+
直接核PRD与AD;按真实目标更新新增/变更/撤销/保留预期,补停用/拒绝/替代、跨主题回归、迁移/恢复,不删失败降门槛,不编执行结果。
|
|
44
|
+
|
|
45
|
+
只写本次明确文档目标,先读现稿与人工修改并保留历史;最后编辑后实际回读。JSON、Plan、任务、代码和生产不是本次写入范围;生成文档后展示路径并交审,不自动登记JSON;用户明确选用后才登记selected,原方法停轮仍保持。
|
|
46
|
+
|
|
47
|
+
当前目标、任务与已实现事实分开;已完成任务保留,未实施取消不记完成,进行中保留真实工作,已实现退役通过新任务。原Plan/Build实际消费须按本轮证据核验,JSON最小辅助已提供但不在本次文稿写入权限内,不自动下阶段、工程、提交或发布。
|
|
48
|
+
|
|
49
|
+
## B05-r2 最后修改后的全文回读
|
|
50
|
+
|
|
51
|
+
全部Write/Edit结束后,必须使用读取工具分段完整覆盖最终目标正文,超出工具截断就续读剩余段。已全文读过但之后又Edit时,须再次完整覆盖最终稿,不能只回读改动行并声称“末次修改后全文已核”。本次必要输入清单中仍有未读/失败/部分读时,先报告准确缺口,不写成已全部读取;补读不是过去已读。
|
|
52
|
+
|
|
53
|
+
未完成收尾就保留实际稿和未核范围,不删除稿件、不补造通过,不登记为已完成回读的完整候选。收尾不改写业务决定,不自动进入下一阶段;只读review/recheck依然零项目写入。
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# TestCase 独立只读审查任务
|
|
2
|
+
|
|
3
|
+
<!-- i3:zh-guide:start -->
|
|
4
|
+
## 中文使用说明
|
|
5
|
+
|
|
6
|
+
按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
|
|
7
|
+
|
|
8
|
+
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
|
+
<!-- i3:zh-guide:end -->
|
|
10
|
+
|
|
11
|
+
先完整读取[统一审查约定](../../review-handoff.md)、本阶段README、完整模板、本次唯一动作、当前业务稿及必要上游/实际采用约束。复查另完整读准确旧稿、原始报告、逐项回应或如实未处理状态。元数据由外层解析不冒充模型已读;自改或未知规则未能确认覆盖时完整读项目选定原件,不回退发行模板。
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
仅在本轮明确企业作业或适用的真实项目选择下使用,标准流程优先保留。实际读项目规则、根README及引用的采用/输出约定,从本轮材料→项目采用副本→同宿主项目安装→可读全局安装定位。由外层解析阶段清单,模型完整读取阶段README、模板、唯一作业提示词及统一审查约定,选定源失效不换新版/其他宿主。模型整理任务卡,用户不必逐项填路径;真实歧义、冲突或覆盖风险才问。
|
|
15
|
+
|
|
16
|
+
内部任务卡包括实际项目根/宿主、阶段与动作、EBC或PBC/主题身份、精确业务来源/版本/条目、模板与提示词/本地修改、唯一展开目标/版本/现稿、允许写入及停点、假设/Q和影响范围。没有计算摘要如实写,不填假SHA,目录或作者摘要不证明已读。
|
|
17
|
+
|
|
18
|
+
真实独立新上下文执行,作者同会话自查不是独立证据。审查者全程只读会话输出,不写候选、项目、报告文件或采用记录;无隔离条件就提供新会话任务,不宣称已独立审查。报告由获准调用者另存。
|
|
19
|
+
|
|
20
|
+
## 本阶段内容核对
|
|
21
|
+
|
|
22
|
+
- §0.2、§6.1按路径、正文版本和条款固定本主题及必要关联组合;公共规范、共享契约/数据权威、提供消费AD、代码/服务/环境版本分别表达,不取最大版本、不强制同号或SHA256,不跨对象比较版本。
|
|
23
|
+
- §3.3、§6.2核唯一业务状态/写入责任、可信租户和主体作用域、幂等重放与新请求的校验顺序、严格消费者及快照过期;产品预期直接核PRD,不复制AD遗漏,不自造正式业务决定。
|
|
24
|
+
- §6.2—§6.4覆盖真实交接、拒绝/失败/UNKNOWN/重复/并发、回执查询、部分成功和恢复;核旧新组合、存量迁移/备份/不可逆限制、必要传递影响及既有行为回归,无关主题不机械改写/升版。
|
|
25
|
+
- §7.1中TestCase是Plan的可选输入:需求、技术约束与验证要求足够即可规划,已有则读取,没有则安排补齐设计;未定判据只限制依赖任务,不取消SPEC六项、必要人审或执行前检查。
|
|
26
|
+
- §0.2明确原test及Build复用TDD,可写测试和实现,不是只读文档生成;原代码review保留五维与临时变异验证,不整体套作零写入的文档review/recheck。本资源不实现JSON登记接点,不自动调用原入口或下阶段。
|
|
27
|
+
- §8.1只定义未来报告的准确组合、实际候选/环境/数据、逐项结果、副作用与证据;替身不关闭必需真实集成,未运行不造runId成功/通过率,实际脚本、Plan、锁和工程未形成不登记未来路径。
|
|
28
|
+
- 原型按需且可与AD并行;保留人工修改、原报告、业务Q、有据不采纳和明确委托修订;文档审查通过不替代代码审查或业务/发布认可。
|
|
29
|
+
|
|
30
|
+
## 发现与结束
|
|
31
|
+
|
|
32
|
+
1. 固定实际候选、来源、模板和本次允许证据,读真实正文而非作者摘要。对每条规范断言核来源、条件/例外/强度及本阶段落实;未提供工程/运行/读取证据明确未核实。
|
|
33
|
+
2. 构造正常/拒绝/失败/未知/重复/恢复及跨主题反例,核权限、状态、字段、事务或用例条件全文一致;不能只核编号数量。逐表核列数和列义,列真实已读范围。
|
|
34
|
+
3. 用稳定发现ID记录严重度、准确位置、来源位置、反例影响和最小建议,区分确定矛盾、缺证、设计候选和可选建议;无真问题如实零项,不替业务回答Q,不触发自动修订。
|
|
35
|
+
4. 输出可交人工审阅/需修订/无法判断、发现/建议/Q及未执行事项后结束。原评级并列保留,不自称业务批准、六项齐备、测试通过、开工或发布许可。
|
|
36
|
+
|
|
37
|
+
## B05 生命周期与必要读取
|
|
38
|
+
|
|
39
|
+
生命周期、模板及交接合同的实质条款按[统一审查约定](../../review-handoff.md)核对;外层解析并保护原索引/合同,未知自改继续完整读本次选定原件;先列本次必读路径和用途,实际核所选正文及必要依赖,未读/失败/部分读照实。只加载本次review动作,不加载其他动作或低优先级源兜底。
|
|
40
|
+
|
|
41
|
+
直接核PRD与AD;按真实目标更新新增/变更/撤销/保留预期,补停用/拒绝/替代、跨主题回归、迁移/恢复,不删失败降门槛,不编执行结果。
|
|
42
|
+
|
|
43
|
+
本次独立只读,仅会话标注问题/来源/影响/最小建议;不改候选、JSON、Plan、代码或报告。人工可修订、有据不采纳或保留Q;原代码review不由此变成只读。
|
|
44
|
+
|
|
45
|
+
当前目标、任务与已实现事实分开;已完成任务保留,未实施取消不记完成,进行中保留真实工作,已实现退役通过新任务。原Plan/Build实际接点和JSON辅助仍待后续,不自动下阶段、工程、提交或发布。
|
|
46
|
+
|
|
47
|
+
## B05收口:单项目审查证据
|
|
48
|
+
|
|
49
|
+
一次只审本次明确的业务项目/主题;必要跨主题来源仍按影响读取。对每条发现和已核事实分别给目标及来源的实际路径、起止行和短原文摘录,再给理由、反例与最小建议。最终会话按统一审查约定和外层传入的同源Schema输出findings、checkedFacts、verdict和未核范围;不能把成功Read一次当读完,不自报未读输入已核。摘录/读取检查通过仍不证明语义结论成立,误报保留反证,不自动改稿。
|
|
50
|
+
|
|
51
|
+
外层解析校验说明并传入同源Schema,模型按统一审查约定输出,保留原文引号并输出合法JSON。原业务输入、旧审查说明与当前任务按调用者实际路径角色表核对;不从旧报告断言推翻真实正文。格式、引用、真实矛盾和可选澄清分别处理,达到当次约定轮次仍未获可接收报告就交人工裁定,不自动修稿。
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# TestCase 明确委托修订任务
|
|
2
|
+
|
|
3
|
+
<!-- i3:zh-guide:start -->
|
|
4
|
+
## 中文使用说明
|
|
5
|
+
|
|
6
|
+
按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
|
|
7
|
+
|
|
8
|
+
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
|
+
<!-- i3:zh-guide:end -->
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
仅在本轮明确企业作业或适用的真实项目选择下使用,标准流程优先保留。实际读项目规则、根README及引用的采用/输出约定,从本轮材料→项目采用副本→同宿主项目安装→可读全局安装定位。读取选定阶段清单、模板、作业提示词及共用合同,选定源失效不换新版/其他宿主。模型整理任务卡,用户不必逐项填路径;真实歧义、冲突或覆盖风险才问。
|
|
13
|
+
|
|
14
|
+
内部任务卡包括实际项目根/宿主、阶段与动作、EBC或PBC/主题身份、精确业务来源/版本/条目、模板与提示词/本地修改、唯一展开目标/版本/现稿、允许写入及停点、假设/Q和影响范围。没有计算摘要如实写,不填假SHA,目录或作者摘要不证明已读。
|
|
15
|
+
|
|
16
|
+
只有本轮明确委托修订才执行,审查意见不自动授予改稿。实际读当前稿、可回读旧稿、固定报告/发现ID、人工修改和真实答复;缺旧稿先停止覆盖。仅改唯一授权候选,不改来源、模板、其他主题、原Skill/命令或采用状态。
|
|
17
|
+
|
|
18
|
+
## 本阶段内容核对
|
|
19
|
+
|
|
20
|
+
- §0.2、§6.1按路径、正文版本和条款固定本主题及必要关联组合;公共规范、共享契约/数据权威、提供消费AD、代码/服务/环境版本分别表达,不取最大版本、不强制同号或SHA256,不跨对象比较版本。
|
|
21
|
+
- §3.3、§6.2核唯一业务状态/写入责任、可信租户和主体作用域、幂等重放与新请求的校验顺序、严格消费者及快照过期;产品预期直接核PRD,不复制AD遗漏,不自造正式业务决定。
|
|
22
|
+
- §6.2—§6.4覆盖真实交接、拒绝/失败/UNKNOWN/重复/并发、回执查询、部分成功和恢复;核旧新组合、存量迁移/备份/不可逆限制、必要传递影响及既有行为回归,无关主题不机械改写/升版。
|
|
23
|
+
- §7.1中TestCase是Plan的可选输入:需求、技术约束与验证要求足够即可规划,已有则读取,没有则安排补齐设计;未定判据只限制依赖任务,不取消SPEC六项、必要人审或执行前检查。
|
|
24
|
+
- §0.2明确原test及Build复用TDD,可写测试和实现,不是只读文档生成;原代码review保留五维与临时变异验证,不整体套作零写入的文档review/recheck。本资源不实现JSON登记接点,不自动调用原入口或下阶段。
|
|
25
|
+
- §8.1只定义未来报告的准确组合、实际候选/环境/数据、逐项结果、副作用与证据;替身不关闭必需真实集成,未运行不造runId成功/通过率,实际脚本、Plan、锁和工程未形成不登记未来路径。
|
|
26
|
+
- 原型按需且可与AD并行;保留人工修改、原报告、业务Q、有据不采纳和明确委托修订;文档审查通过不替代代码审查或业务/发布认可。
|
|
27
|
+
|
|
28
|
+
## 修订与结束
|
|
29
|
+
|
|
30
|
+
1. 写前逐项列发现ID→是否成立→来源理由→最小改动→影响;误报有据说明,业务未答保持Q,不为清零编造权限、指标、正式契约或通过结果。
|
|
31
|
+
2. 同一问题修复到当前稿所有相关位置,保留有效目标、原编号及人工修改。上游需要改变仅标注,不越界改源;草稿修订与新业务版本分开,不机械升版或强制配套同号。
|
|
32
|
+
3. 最后一次编辑后实际回读最终目标及受影响上下文;新增规范要求逐条回源,权限/状态/副作用一致,全文逐表核列数和列义,引用和覆盖重核;再改则按收尾规则再次完整回读最终稿,并重核受影响来源与检查。
|
|
33
|
+
4. 逐发现回应实际处理位置、来源、剩余问题及未执行事项,修订说明由获准调用者另存。请求必要独立复查和人工审阅后停轮,不自批或自动下一阶段/Plan/Build/测试执行/发布。
|
|
34
|
+
|
|
35
|
+
## B05 生命周期与必要读取
|
|
36
|
+
|
|
37
|
+
按选定资源索引实际读lifecycleContract及共用模板/交接合同;先列本次必读路径和用途,实际核所选正文及必要依赖,未读/失败/部分读照实。只加载本次revise动作,不加载其他动作或低优先级源兜底。
|
|
38
|
+
|
|
39
|
+
直接核PRD与AD;按真实目标更新新增/变更/撤销/保留预期,补停用/拒绝/替代、跨主题回归、迁移/恢复,不删失败降门槛,不编执行结果。
|
|
40
|
+
|
|
41
|
+
只写本次明确文档目标,先读现稿与人工修改并保留历史;最后编辑后实际回读。JSON、Plan、任务、代码和生产不是本次写入范围;生成文档后展示路径并交审,不自动登记JSON;用户明确选用后才登记selected,原方法停轮仍保持。
|
|
42
|
+
|
|
43
|
+
当前目标、任务与已实现事实分开;已完成任务保留,未实施取消不记完成,进行中保留真实工作,已实现退役通过新任务。原Plan/Build实际接点和JSON辅助仍待后续,不自动下阶段、工程、提交或发布。
|
|
44
|
+
|
|
45
|
+
## B05-r2 最后修改后的全文回读
|
|
46
|
+
|
|
47
|
+
全部Write/Edit结束后,必须使用读取工具分段完整覆盖最终目标正文,超出工具截断就续读剩余段。已全文读过但之后又Edit时,须再次完整覆盖最终稿,不能只回读改动行并声称“末次修改后全文已核”。本次必要输入清单中仍有未读/失败/部分读时,先报告准确缺口,不写成已全部读取;补读不是过去已读。
|
|
48
|
+
|
|
49
|
+
未完成收尾就保留实际稿和未核范围,不删除稿件、不补造通过,不登记为已完成回读的完整候选。收尾不改写业务决定,不自动进入下一阶段;只读review/recheck依然零项目写入。
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# TestCase 独立只读复查任务
|
|
2
|
+
|
|
3
|
+
<!-- i3:zh-guide:start -->
|
|
4
|
+
## 中文使用说明
|
|
5
|
+
|
|
6
|
+
按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
|
|
7
|
+
|
|
8
|
+
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
|
+
<!-- i3:zh-guide:end -->
|
|
10
|
+
|
|
11
|
+
先完整读取[统一审查约定](../../review-handoff.md)、本阶段README、完整模板、本次唯一动作、当前业务稿及必要上游/实际采用约束。复查另完整读准确旧稿、原始报告、逐项回应或如实未处理状态。元数据由外层解析不冒充模型已读;自改或未知规则未能确认覆盖时完整读项目选定原件,不回退发行模板。
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
仅在本轮明确企业作业或适用的真实项目选择下使用,标准流程优先保留。实际读项目规则、根README及引用的采用/输出约定,从本轮材料→项目采用副本→同宿主项目安装→可读全局安装定位。由外层解析阶段清单,模型完整读取阶段README、模板、唯一作业提示词及统一审查约定,选定源失效不换新版/其他宿主。模型整理任务卡,用户不必逐项填路径;真实歧义、冲突或覆盖风险才问。
|
|
15
|
+
|
|
16
|
+
内部任务卡包括实际项目根/宿主、阶段与动作、EBC或PBC/主题身份、精确业务来源/版本/条目、模板与提示词/本地修改、唯一展开目标/版本/现稿、允许写入及停点、假设/Q和影响范围。没有计算摘要如实写,不填假SHA,目录或作者摘要不证明已读。
|
|
17
|
+
|
|
18
|
+
真实独立新上下文执行,作者同会话自查不是独立证据。审查者全程只读会话输出,不写候选、项目、报告文件或采用记录;无隔离条件就提供新会话任务,不宣称已独立审查。报告由获准调用者另存。
|
|
19
|
+
|
|
20
|
+
## 本阶段内容核对
|
|
21
|
+
|
|
22
|
+
- §0.2、§6.1按路径、正文版本和条款固定本主题及必要关联组合;公共规范、共享契约/数据权威、提供消费AD、代码/服务/环境版本分别表达,不取最大版本、不强制同号或SHA256,不跨对象比较版本。
|
|
23
|
+
- §3.3、§6.2核唯一业务状态/写入责任、可信租户和主体作用域、幂等重放与新请求的校验顺序、严格消费者及快照过期;产品预期直接核PRD,不复制AD遗漏,不自造正式业务决定。
|
|
24
|
+
- §6.2—§6.4覆盖真实交接、拒绝/失败/UNKNOWN/重复/并发、回执查询、部分成功和恢复;核旧新组合、存量迁移/备份/不可逆限制、必要传递影响及既有行为回归,无关主题不机械改写/升版。
|
|
25
|
+
- §7.1中TestCase是Plan的可选输入:需求、技术约束与验证要求足够即可规划,已有则读取,没有则安排补齐设计;未定判据只限制依赖任务,不取消SPEC六项、必要人审或执行前检查。
|
|
26
|
+
- §0.2明确原test及Build复用TDD,可写测试和实现,不是只读文档生成;原代码review保留五维与临时变异验证,不整体套作零写入的文档review/recheck。本资源不实现JSON登记接点,不自动调用原入口或下阶段。
|
|
27
|
+
- §8.1只定义未来报告的准确组合、实际候选/环境/数据、逐项结果、副作用与证据;替身不关闭必需真实集成,未运行不造runId成功/通过率,实际脚本、Plan、锁和工程未形成不登记未来路径。
|
|
28
|
+
- 原型按需且可与AD并行;保留人工修改、原报告、业务Q、有据不采纳和明确委托修订;文档审查通过不替代代码审查或业务/发布认可。
|
|
29
|
+
|
|
30
|
+
## 复查与结束
|
|
31
|
+
|
|
32
|
+
1. 固定实际修订稿、旧稿/原报告/逐项回应、人工答复、来源和模板;发现集或版本不对应先澄清,不猜最新。读实际全文和相关上下文,不能只看差异/作者摘要;后补读取不追认为历史已读。
|
|
33
|
+
2. 按稳定发现ID分别判已关闭/部分关闭/未关闭/无法核实,给修订后位置、来源与理由;误报排除也有据,局部改正但相关条件仍矛盾不得关闭。
|
|
34
|
+
3. 检查修订回归:新增要求来源与强度/例外、权限/状态/字段、拒绝/失败/未知/恢复、跨主题配套及覆盖。全文逐表核列数和列义,保留有效目标、Q和人工处理依据。
|
|
35
|
+
4. 新问题用新ID标位置、来源、反例影响和建议,区分必修/缺证/可选。输出可交人工审阅/需修订/无法判断、逐发现结果、Q/建议、已读和未执行后停轮;零必修不代业务/工程/测试/发布通过,不自动改稿或更新采用。
|
|
36
|
+
|
|
37
|
+
## B05 生命周期与必要读取
|
|
38
|
+
|
|
39
|
+
生命周期、模板及交接合同的实质条款按[统一审查约定](../../review-handoff.md)核对;外层解析并保护原索引/合同,未知自改继续完整读本次选定原件;先列本次必读路径和用途,实际核所选正文及必要依赖,未读/失败/部分读照实。只加载本次recheck动作,不加载其他动作或低优先级源兜底。
|
|
40
|
+
|
|
41
|
+
直接核PRD与AD;按真实目标更新新增/变更/撤销/保留预期,补停用/拒绝/替代、跨主题回归、迁移/恢复,不删失败降门槛,不编执行结果。
|
|
42
|
+
|
|
43
|
+
本次独立只读,仅会话标注问题/来源/影响/最小建议;不改候选、JSON、Plan、代码或报告。人工可修订、有据不采纳或保留Q;原代码review不由此变成只读。
|
|
44
|
+
|
|
45
|
+
当前目标、任务与已实现事实分开;已完成任务保留,未实施取消不记完成,进行中保留真实工作,已实现退役通过新任务。原Plan/Build实际接点和JSON辅助仍待后续,不自动下阶段、工程、提交或发布。
|
|
46
|
+
|
|
47
|
+
## B05收口:单项目审查证据
|
|
48
|
+
|
|
49
|
+
一次只审本次明确的业务项目/主题;必要跨主题来源仍按影响读取。对每条发现和已核事实分别给目标及来源的实际路径、起止行和短原文摘录,再给理由、反例与最小建议。最终会话按统一审查约定和外层传入的同源Schema输出findings、checkedFacts、verdict和未核范围;不能把成功Read一次当读完,不自报未读输入已核。摘录/读取检查通过仍不证明语义结论成立,误报保留反证,不自动改稿。
|
|
50
|
+
|
|
51
|
+
外层解析校验说明并传入同源Schema,模型按统一审查约定输出,保留原文引号并输出合法JSON。若本次仅纠正旧报告格式/来源证据,明确局部范围,实际读当前目标全文与本次涉及的来源,按角色表区分原业务、旧审查及当前指令;误报保留原ID与反证,真实问题和人工Q不为清零而删除。达到当次约定轮次仍失败交人工裁定,不重写业务稿或替换原始失败输出。
|
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
# TestCase 模板
|
|
2
|
+
|
|
3
|
+
<!-- i3:zh-guide:start -->
|
|
4
|
+
## 中文使用说明
|
|
5
|
+
|
|
6
|
+
按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
|
|
7
|
+
|
|
8
|
+
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
|
+
<!-- i3:zh-guide:end -->
|
|
10
|
+
|
|
11
|
+
原型只在本次实际适用且已采用时作为输入,不因缺少原型一律停止测试设计;依赖未定交互的用例明确待确认,其他场景可以继续。最终技术判据仍需核对选定 PRD 和有效 AD,起草不等于已经执行测试。
|
|
12
|
+
|
|
13
|
+
**审查只标注,使用者决定处理。**文档审查者只读标注问题、准确位置、来源、影响和修改建议,不直接修改候选。使用者可以人工修改、明确委托模型修订、有依据地不采纳建议,或将业务问题保持待确认;审查意见不自动触发改写。保留旧稿、人工修改、原报告和逐项处理依据,按项目既有约束进行必要复查;缺少真实答复不为清零而补造规则,人工编辑也不自动等于审查通过或业务批准。
|
|
14
|
+
|
|
15
|
+
模板版本:v0.0.4。日期:2026-10-18。状态:自有资源候选;模板可供明确采用,业务内容与认可另行记录。
|
|
16
|
+
|
|
17
|
+
采用[模板与交接合同](../../template-contracts.md)。实例文件名为 `{PBC}-{需求主题}-TestCase_v0.0.1.md`,其中包含多条用例与回归/评估安排。直接读取选定的 PRD、AD 和适用原型,不只从 AD 反推需求;设计遗漏也应被覆盖检查发现。所需条件、判据和报告合同先明确,真实执行结果另写一份或多份 TestReport,不预填通过结论。
|
|
18
|
+
|
|
19
|
+
本模板承接原 SPEC 的测试策略:明确框架、测试目录、测试层级和适用覆盖要求,并固定引用 AD 的完整测试命令及运行条件。测试代码、实际报告、CONSTRAINTS 与其他辅助产物继续按原方法保留;本模板不替代原 TDD、浏览器或其他 Skill 的工具、步骤、停点和验证要求,也不强制复制 SPEC。
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
# {PBC名称} · {需求主题} — 测试用例与验证合同
|
|
24
|
+
|
|
25
|
+
## 0. 身份与固定输入
|
|
26
|
+
|
|
27
|
+
| 项目 | 本次实际值 |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| 能力/需求主题 | `{PBC capabilityId/名称;稳定prdId/主题;适用EBC引用}` |
|
|
30
|
+
| 文档身份/版本/位置 | `{documentId;实际版本;可回读路径/固定内容及摘要}` |
|
|
31
|
+
| 直接 PRD 依据 | `{选定主题、PRD版本、具体条目、固定内容与摘要}` |
|
|
32
|
+
| 直接 AD 依据 | `{选定AD版本/固定内容/摘要;其产品引用与本PRD是否一致}` |
|
|
33
|
+
| 原型、契约与质量规则 | `{适用原型版本/认可范围;接口、数据、项目规范固定引用;不适用或缺项说明}` |
|
|
34
|
+
| 当前范围/比较基准 | `{全部有效目标、变化和保留;前次用例/真实实现及历史运行,不混为当前通过证明}` |
|
|
35
|
+
| 模板/责任/状态 | `{固定模板;设计、复核、执行与业务验收责任;未指定如实写}` |
|
|
36
|
+
|
|
37
|
+
### 0.1 输入与确认核对
|
|
38
|
+
|
|
39
|
+
| 输入 ID | 身份/版本/具体条目 | 固定内容/摘要与已读范围 | 用途与权威定义 | 认可/真实可用性/缺口 |
|
|
40
|
+
| --- | --- | --- | --- | --- |
|
|
41
|
+
| `{别名}` | `{PRD/AD/原型/外部规范/真实答复}` | `{可回读引用}` | `{产品预期/技术约束/交互等}` | `{分别记录,不由文件存在推定}` |
|
|
42
|
+
|
|
43
|
+
本 TestCase 对应本次选定的一个 AD 版本;后续方法改进可形成新 TestCase 版本而不强制改变 AD 或 PRD 版本。同一能力其他主题可以有自己的用例集,组合交付时显式选择配套集合及集成范围,不自动合并目录中全部最新文件。
|
|
44
|
+
|
|
45
|
+
### 0.2 跨主题采用依据与原方法分工
|
|
46
|
+
|
|
47
|
+
先读本主题选定PRD与直接配套AD,再按实际共享定义读取项目已采用公共技术规约、契约正文和必要关联主题。关联AD/TestCase只用于本次组合和交接,不替代本主题产品来源,不把整目录最大版本或未采用候选纳入。基本引用按实际路径、正文版本与条款核对,摘要可选;来源失效或冲突列Q及受影响范围,不静默换源,也不从历史测试恢复旧答案。
|
|
48
|
+
|
|
49
|
+
| 方法/产物 | 职责与输入 | 输出及权限边界 |
|
|
50
|
+
| --- | --- | --- |
|
|
51
|
+
| 企业TestCase | 按PRD产品预期、AD技术判据及采用规范设计用例 | 测试设计与报告合同,不编写测试代码、不运行测试、不预填结果 |
|
|
52
|
+
| 原Plan | 按当前范围的需求、设计、验证要求及真实工程拆任务 | 原tasks/plan.md和唯一任务目标;TestCase为可选输入,已有则引用,没有则安排补齐设计,不统一阻断规划 |
|
|
53
|
+
| 原Build/test | 按获准任务及相关来源执行原TDD、缺陷复现、回归与适用浏览器验证 | 业务与测试代码、实际运行及构建证据;不是只读文档作业,不更改原方法或质量门槛 |
|
|
54
|
+
| 企业文档review/recheck | 独立上下文核来源、语义、覆盖和报告约定 | 零项目写入,只在会话标注;有据人工处理或明确委托修订 |
|
|
55
|
+
| 原代码review | 对真实代码与测试差异作原五维审查及验证 | 保留原检查和结论标准;其中临时变异检查后恢复源码涉及写入,不能整体套作零写入的文档审查 |
|
|
56
|
+
|
|
57
|
+
原test是开发/修复中的TDD入口,Build也复用它;不要求每次Build之后重复执行同一无变化测试。文档审查通过不替代代码审查、测试或人类认可,保留人工修改空间不降低原合并和发布要求。原命令不天然发现企业TestCase或JSON,实际交接需明确任务或已采用指引;本资源不实现JSON登记接点、自动跨阶段执行或宿主路由。
|
|
58
|
+
|
|
59
|
+
## 1. 验证目标、范围与排除
|
|
60
|
+
|
|
61
|
+
`{本主题需要证明的业务行为、全部AC/复合子项、关键端到端流程、相关工程质量及受影响既有功能。产品功能验收与运行后业务效果分别说明;未知阈值或观察周期标待确认,不编造。}`
|
|
62
|
+
|
|
63
|
+
| 验证对象 | 本次纳入内容 | 排除/暂不能执行范围及理由 | 依赖/风险 | 所需方法 |
|
|
64
|
+
| --- | --- | --- | --- | --- |
|
|
65
|
+
| `{功能/数据/权限/恢复/性能/交互等}` | `{稳定条目}` | `{必须有依据,不能暗降标准}` | `{具体问题}` | `{测试/测量/业务评审/运行观察}` |
|
|
66
|
+
|
|
67
|
+
缺少环境不必阻止不依赖它的用例设计,但不能把不可执行范围写成已经通过。
|
|
68
|
+
|
|
69
|
+
## 2. PRD、AD 与用例覆盖
|
|
70
|
+
|
|
71
|
+
先从 PRD 独立列出应验证的产品结果,再核对 AD 对应实现和技术风险。AD 没有设计某个需求时登记缺口,不随之删除用例或产品预期。
|
|
72
|
+
|
|
73
|
+
| PRD需求/AC/子项与版本 | 产品预期与来源 | AD条款/字段/契约/状态及版本 | 用例/参数子场景 | 层次与对象 | 设计覆盖缺口 |
|
|
74
|
+
| --- | --- | --- | --- | --- | --- |
|
|
75
|
+
| `{稳定引用}` | `{不能只写需求原文摘要}` | `{精确位置或遗漏}` | `{实际TC ID及子项}` | `{单元/契约/集成/E2E/原型/正式实现/运行观察}` | `{已设计/待明确/不适用及依据,不是执行结果}` |
|
|
76
|
+
|
|
77
|
+
| 工程要求与来源 | 条件/风险 | 技术预期 | 相关产品要求 | 用例/评估及证据要求 | 未决 |
|
|
78
|
+
| --- | --- | --- | --- | --- | --- |
|
|
79
|
+
| `{AD或适用公共质量条款}` | `{实际条件}` | `{有依据的可判断结果}` | `{相关则引用}` | `{具体方法}` | `{问题ID}` |
|
|
80
|
+
|
|
81
|
+
复合 AC 各子项均应有去向;一部分子项有用例不代表整条覆盖完整。用例与需求/设计可以多对多,不按文档配套关系强行一项一个用例,也不用数量或覆盖率代替语义正确性。
|
|
82
|
+
|
|
83
|
+
## 3. 所需环境、身份、数据与依赖
|
|
84
|
+
|
|
85
|
+
### 3.1 测试策略、框架、目录与覆盖要求
|
|
86
|
+
|
|
87
|
+
先核实项目已有测试体系,按实际范围选择层级,保留原技能要求;不因套用模板改框架、替换工具、跳过红绿重构或降低质量门槛。下表定义验证方法和所需条件,不表示框架已安装、用例已实现或测试已通过。
|
|
88
|
+
|
|
89
|
+
| 测试层级/验证对象 | 关注点与需求/技术依据 | 框架/工具及精确版本 | 测试目录与配置位置 | 命令引用及运行条件 | 适用覆盖要求及来源 | 当前事实与缺口 |
|
|
90
|
+
| --- | --- | --- | --- | --- | --- | --- |
|
|
91
|
+
| 单元 | `{适合独立断言的逻辑、状态及错误分支}` | `{已有框架/runner版本或待确认}` | `{实际测试目录、命名和固定配置}` | `{AD §9.1的完整命令/cwd;聚焦及回归范围}` | `{适用语义/分支或既有覆盖指标、口径及来源}` | `{已存在/拟建/不可执行分别记录}` |
|
|
92
|
+
| 契约/集成 | `{API、数据、权限、事务和外部依赖交接}` | `{实际工具及版本}` | `{测试与夹具/契约配置目录}` | `{命令引用;身份、数据、依赖及替身限制}` | `{接口/状态/副作用/拒绝路径等具体要求}` | `{真实依赖可用性另行核实}` |
|
|
93
|
+
| E2E/浏览器 | `{实际用户流程、组件交互与可访问性}` | `{按适用原方法要求的真实工具及版本}` | `{场景/脚本/配置目录;暂无脚本如实注明}` | `{命令或工具操作引用;实际页面/服务候选及条件}` | `{关键流程、视口/角色/状态等有来源范围}` | `{不适用或缺工具说明依据,不静默换工具}` |
|
|
94
|
+
| 其他适用验证 | `{性能、恢复、Agent行为评价或业务运行观察}` | `{实际方法/工具/样本固定版本}` | `{评估、测量或观察记录的实际位置}` | `{明确入口、条件及责任,不强造CLI}` | `{适用负载/样本/重复次数/判据及来源}` | `{仅所需维度;不适用要说明}` |
|
|
95
|
+
|
|
96
|
+
每层级说明“验证什么、用什么、放哪里、怎样运行、怎样算足够”。数量和代码覆盖率不能替代第2章的需求/AC语义覆盖;采用数值要求时记录指标类型、分母/排除项、测量条件和固定来源。未知阈值标待确认,既有 CONSTRAINTS 或项目质量要求不得暗降;没有依据不编造统一覆盖率。
|
|
97
|
+
|
|
98
|
+
完整可执行命令和 cwd 以选定 AD §9.1 为权威,测试目录与 AD §9.2 核对,框架/工具版本与采用的依赖或配置相符。若需新增入口或修改命令,返回对应工程定义处理,不能在此维护第二份不同答案。实际执行报告记录真正使用的框架、配置、目录、命令和覆盖结果,未运行不预填测量值。
|
|
99
|
+
|
|
100
|
+
### 3.2 身份、环境、数据和依赖条件
|
|
101
|
+
|
|
102
|
+
| 条件 ID | 所需配置/状态及固定依据 | 适用用例 | 真实依赖/替身边界 | 准备/清理/恢复要求 | 责任/缺口 |
|
|
103
|
+
| --- | --- | --- | --- | --- | --- |
|
|
104
|
+
| `{稳定ID}` | `{环境、身份/租户/权限、数据状态、依赖版本、配置、工具}` | `{TC或子项}` | `{模拟只能证明什么}` | `{可重复且不破坏无关数据}` | `{实际主体或未指定}` |
|
|
105
|
+
|
|
106
|
+
本章定义所需条件;它们的实际就绪情况在执行前独立核实。示例身份不等于真实授权,模拟服务不等于已接通真实依赖,不将生产数据或高风险故障注入当默认测试材料。
|
|
107
|
+
|
|
108
|
+
### 3.3 跨主题组合的执行条件
|
|
109
|
+
|
|
110
|
+
| 条件ID/组合ID | 提供/消费方及受影响用例 | 规范/契约/数据/实现的选定引用 | 就绪核实与真实/替身边界 | 准备、失败、清理及恢复 | 缺口及可继续部分 |
|
|
111
|
+
| --- | --- | --- | --- | --- | --- |
|
|
112
|
+
| `{与§6.1组合对应}` | `{只列本次实际角色,不擅定人员}` | `{文档版本与代码/服务版本分别记录}` | `{真实凭据范围、存量数据、时钟/快照及依赖;未核实照录}` | `{可重复夹具、操作授权、回执核实、恢复证据及不可逆限制}` | `{问题ID及依赖范围,不扩大到无关任务}` |
|
|
113
|
+
|
|
114
|
+
设计就绪、服务存在、权限有效和可真实集成分别核实。替身可用于内部验证,不能证明正式契约与真实提供方互通;真实依赖缺失时相关用例标待执行/阻断,不靠模拟响应关闭。故障注入、迁移和恢复只在获准环境与数据范围执行;未取得授权或来源不明的数字、保留期、并存窗口及平台参数保留Q。
|
|
115
|
+
|
|
116
|
+
## 4. 详细用例(逐用例填写)
|
|
117
|
+
|
|
118
|
+
### {TC ID} · {用例名称}
|
|
119
|
+
|
|
120
|
+
1. **来源**:`{PRD需求/AC/子项、AD技术条款及其他适用规范的身份、版本和准确位置}`。
|
|
121
|
+
2. **目标与层次**:`{本用例证明什么;单元/契约/集成/浏览器/业务评审等,明确原型还是正式实现}`。
|
|
122
|
+
3. **前置与测试数据**:`{可信身份、权限/租户/资源范围、业务状态、候选与依赖/数据版本、来源和准备条件}`。
|
|
123
|
+
4. **步骤与输入**:`{可重复的操作、请求、事件、并发顺序或故障注入;各参数子场景独立定位}`。
|
|
124
|
+
5. **预期结果**:`{业务结果、状态、响应、可见反馈;有来源的精确判断,不由实现反推}`。
|
|
125
|
+
6. **允许/禁止副作用**:`{成功允许的数据/事件/审计/通知变化;拒绝、失败、重复、未知结果时禁止额外变化什么}`。
|
|
126
|
+
7. **判定方法**:`{断言、权威数据核查、测量、对照或明确评审;每项预期怎样判断}`。
|
|
127
|
+
8. **清理、恢复与证据**:`{数据恢复边界、请求/响应、数据库/事务记录、截图、日志、指标等;恢复失败如何记录}`。
|
|
128
|
+
9. **自动化与实现引用**:`{适合自动化/需人工及理由;脚本实际存在才登记固定路径/版本,尚无则写待实现}`。
|
|
129
|
+
|
|
130
|
+
| 子场景 ID | 特定输入/调度/故障 | 产品/技术预期及副作用 | 所需证据 | 不可执行或未决原因 |
|
|
131
|
+
| --- | --- | --- | --- | --- |
|
|
132
|
+
| `{复合或参数化分支}` | `{独立可复现条件}` | `{明确判断}` | `{对应结果}` | `{无或问题引用}` |
|
|
133
|
+
|
|
134
|
+
此处只写预期和方法,不填写通过、失败、执行日期或伪造运行截图。产品预期含糊回 PRD,技术判据含糊回 AD;不能改测试方法时暗改业务规则或临时降低阈值。
|
|
135
|
+
|
|
136
|
+
## 5. 必要路径与专项验证
|
|
137
|
+
|
|
138
|
+
| 维度 | 适用场景 | 方法与判据来源 | 用例/样本版本 | 所需证据/不适用依据 |
|
|
139
|
+
| --- | --- | --- | --- | --- |
|
|
140
|
+
| 主流程与数据一致性 | `{完整链路和事实维护}` | `{PRD/AD固定条款}` | `{实际引用}` | `{权威结果}` |
|
|
141
|
+
| 权限与隔离 | `{员工/管理员等真实角色、直接入口/接口越权、跨组织/租户/资源}` | `{不能只隐藏按钮}` | `{实际引用}` | `{请求拒绝及禁止泄露/写入的证据}` |
|
|
142
|
+
| 状态、并发与幂等 | `{允许/拒绝转换、重复请求、竞争、超时未知和恢复}` | `{AD事务/版本/幂等定义}` | `{实际引用}` | `{最终状态及副作用}` |
|
|
143
|
+
| 交互与可访问性 | `{空态、失败、长内容、窄屏、键盘/焦点、错误可达}` | `{认可原型及PRD/AD}` | `{浏览器场景}` | `{实际执行/截图/控制台}` |
|
|
144
|
+
| 数据与迁移 | `{约束、字段映射、旧值、回填、兼容/回退}` | `{AD精确契约}` | `{实际引用}` | `{设计DDL不等于迁移回执}` |
|
|
145
|
+
| 性能、可靠性与恢复 | `{实际负载和故障}` | `{来源阈值/条件;未知不造值}` | `{方法/样本}` | `{测量和恢复证据}` |
|
|
146
|
+
| 智能能力(适用时) | `{正确性、工具权限、副作用、拒绝、预算及恢复}` | `{模型/Prompt/样本固定版本和评估规则}` | `{重复评估及分支}` | `{不以单次成功代替约定评估}` |
|
|
147
|
+
|
|
148
|
+
维度用于核对,不要求无相关需求的产品强行增加功能或专项;不适用要有明确依据。
|
|
149
|
+
|
|
150
|
+
## 6. 跨主题组合、变化与回归
|
|
151
|
+
|
|
152
|
+
| 变更前基准/本次目标 | 受影响主题/功能/状态/契约 | 保留/修订/新增/停止适用的用例 | 选择依据与风险 | 必须重取的证据 |
|
|
153
|
+
| --- | --- | --- | --- | --- |
|
|
154
|
+
| `{PRD/AD/用例/代码固定引用}` | `{精确范围}` | `{版本与替代关系}` | `{未变ID不等于未变预期}` | `{需求/实现/依赖/环境变化影响}` |
|
|
155
|
+
|
|
156
|
+
多主题组合登记各自 PRD/AD/TestCase 版本,检查共享状态/字段/权限/接口一致性与交接,不以单份检查通过代替组合验证。历史运行仍保留在原对象和环境版本下;未受影响的证据也需说明适用依据,不直接复制为新目标通过。
|
|
157
|
+
|
|
158
|
+
### 6.1 明确本次兼容组合
|
|
159
|
+
|
|
160
|
+
| 组合ID/作用范围 | 本主题PRD/AD/TestCase实际路径和各自版本 | 提供/消费方主题及配套引用 | 公共规范条款/契约与数据权威 | 实现/制品/环境事实 | 设计判断、执行状态与缺口 |
|
|
161
|
+
| --- | --- | --- | --- | --- | --- |
|
|
162
|
+
| `{独立主题或本次集成组合}` | `{以正文及真实采用为准,不强制同号}` | `{仅相关范围;缺关联TestCase如实记,不造未来文件路径}` | `{准确位置/版本;实际共享定义不在用例中复制另一权威}` | `{已有/拟建/未知;代码或服务不存在不填已部署}` | `{相容/冲突/待核实与依据;不预填运行通过}` |
|
|
163
|
+
|
|
164
|
+
一个主题TestCase仍对应本主题选定PRD和一个直接AD版本,关联引用用于组合场景;不用总用例文档包办全部主题,不要求双方版本数值一致。文档、契约、代码、服务各自版本属于不同对象,不能跨对象比较大小或据同号/SemVer/Schema校验宣布语义兼容。默认值、枚举、权限、错误、副作用及严格消费者均应核对。
|
|
165
|
+
|
|
166
|
+
### 6.2 跨边界场景与最终权威
|
|
167
|
+
|
|
168
|
+
| 组合/场景及用例ID | 来源PRD/AC与AD/契约条款 | 提供→消费路径与边界 | 权威结果与禁止副作用 | 失败/未知/重复及恢复预期 | 实际证据要求及缺口 |
|
|
169
|
+
| --- | --- | --- | --- | --- | --- |
|
|
170
|
+
| `{正常交接/拒绝/冲突/过期/并发/取消等适用场景}` | `{产品预期直接核PRD;技术定义核AD及唯一契约}` | `{身份、租户/资源范围、输入映射、事务或消息边界}` | `{业务状态及实体唯一维护方;副本、前端、Agent运行、jobs状态分别判断}` | `{错误映射、回执查询、同key重放、恢复后状态与人工介入条件}` | `{请求/响应、权威数据、版本及副作用核查;仅计划所需证据}` |
|
|
171
|
+
|
|
172
|
+
至少检查适用的跨租户拒绝、重复与不同负载冲突、并发版本冲突、响应丢失/超时UNKNOWN、只读快照过期、未知枚举、部分成功及恢复。已完成请求重放与新请求的状态/版本校验顺序按权威契约分别设计,不能把初次前置照搬到重放导致有效重放被拒。可信主体和幂等键的租户/主体作用域、查回执的授权与隔离均有据;不只验证界面按钮或方法调用次数。
|
|
173
|
+
|
|
174
|
+
共享实体可由多个经授权主体操作,但最终业务定义、校验和写入边界必须唯一明确。消费者不得直写提供方数据;执行器结束、缓存刷新或前端成功状态不自动等于业务完成。过期/未知的预期来自正式定义,缺定义列Q而非选择成功分支。
|
|
175
|
+
|
|
176
|
+
### 6.3 版本并存、迁移及恢复设计
|
|
177
|
+
|
|
178
|
+
| 组合变化/来源 | 旧/新提供消费版本及数据状态 | 必需场景、顺序与兼容判断 | 备份/迁移/恢复/不可逆限制 | 判据和所需证据 | 未决与受限范围 |
|
|
179
|
+
| --- | --- | --- | --- | --- | --- |
|
|
180
|
+
| `{共享定义或实际装配改变}` | `{仅列真实已选或明确拟议对象}` | `{严格消费者、默认/权限/枚举变化、在途请求、并存窗口和部署顺序}` | `{来源明确的准备、故障点、对账和恢复条件;不把改回镜像等同恢复数据}` | `{真实命令/操作与前后权威数据;未执行不得声称可回滚}` | `{缺决定或资源时可设计、不冒认运行就绪}` |
|
|
181
|
+
|
|
182
|
+
### 6.4 变更影响与既有行为回归
|
|
183
|
+
|
|
184
|
+
| 变化条款/权威位置 | 直接及必要传递影响 | 受影响主题AD/AC/用例及已有任务 | 必须保留/补取的回归证据 | 无关范围与不受影响依据 | 处理决定/Q |
|
|
185
|
+
| --- | --- | --- | --- | --- | --- |
|
|
186
|
+
| `{公共规范、契约、实体、代码或环境的实际变化}` | `{定义→提供方→消费者→必要下游}` | `{有真实任务才登记,不造Plan或tracker项}` | `{旧调用方、拒绝、未知与恢复及既有业务行为}` | `{未消费该定义或明确不受影响;不机械改写全部主题}` | `{降级/移出必需回归要真实理由与决定}` |
|
|
187
|
+
|
|
188
|
+
公共变化不能只查本主题,也不能把所有AD/PRD统一升版。共享底座、迁移和测试夹具的后续工程修改应在唯一任务目标安排归属,相关任务列依赖;本次仅设计,不生成第二份Plan或竞争tracker,不改人工代码及其他主题。
|
|
189
|
+
|
|
190
|
+
## 7. 两种结论与执行准入
|
|
191
|
+
|
|
192
|
+
### 7.1 用例规格可交接
|
|
193
|
+
|
|
194
|
+
`{明确当前范围预期、方法、覆盖、所需条件、未决影响及报告约定是否足够,分别列可交接与仍缺定义范围。此结论不表示代码存在、环境可用或测试已运行。}`
|
|
195
|
+
|
|
196
|
+
**TestCase是Plan的可选输入,不是统一前置文件。**当前范围的需求、技术约束和测试策略/验收预期可从PRD、AD及已采用规范充分回读时,可先按原Plan拆任务;没有独立TestCase不要求先补一份才能规划。已有且适用的TestCase应读取准确版本并落实到任务验收和验证步骤;缺少或待补的用例设计可作为计划任务,相关验证定义在依赖它的实现、测试或验收之前明确。核心行为或技术判据尚不明确时,只限制相应依赖任务,不把计划先行等同编码、测试或发布许可。
|
|
197
|
+
|
|
198
|
+
测试策略可在AD或现有测试规范中承载原SPEC六项的相应要求,不能因TestCase可选而跳过六项核对。企业SOP仍保留本主题TestCase设计交付,允许其与规划按依赖衔接,不取消正式交付所要求的验证定义。用例与任务、脚本可以多对多;只有真实脚本和任务形成后才登记实际路径,人工用例明确执行方式,不伪造全部自动化。
|
|
199
|
+
|
|
200
|
+
### 7.2 执行可准入(候选形成后另存核实记录)
|
|
201
|
+
|
|
202
|
+
| 执行前须核实的对象 | 条件与依据 | 核实结果应保存什么 |
|
|
203
|
+
| --- | --- | --- |
|
|
204
|
+
| 候选 | `{代码提交/构建制品与所选需求和用例版本一致}` | `{实际对象及摘要}` |
|
|
205
|
+
| 环境、数据、依赖 | `{满足第3章条件,真实与替身边界清楚}` | `{实际版本/配置/数据/可用性证据}` |
|
|
206
|
+
| 任务和操作授权 | `{Plan范围/执行模式及适用高风险动作授权}` | `{可信来源;沿用有效授权,不自填批准}` |
|
|
207
|
+
| 内容新鲜度与安全边界 | `{版本未变、影响已复核、清理/恢复可执行}` | `{失效范围、阻断用例或独立可执行部分}` |
|
|
208
|
+
|
|
209
|
+
准入结论由实际核实产生并保存到独立记录,不回填本章为永久通过。设计可用于形成 Plan,不要求先有获批 Plan 才能编写计划;真正运行才核实计划认可和实际执行条件。缺必需条件的用例不准入、不算通过。
|
|
210
|
+
|
|
211
|
+
### 7.3 适用通过判据、缺陷处理与重测
|
|
212
|
+
|
|
213
|
+
| 验收对象/范围 | 本次必需用例与证据 | 通过口径及来源 | 阻断缺陷/风险接受依据 | 修复后的重测与回归范围 |
|
|
214
|
+
| --- | --- | --- | --- | --- |
|
|
215
|
+
| `{功能、权限、数据、恢复、工程或质量条目}` | `{明确TC ID、适用子场景、真实运行/人工验收/测量等所需证据}` | `{按PRD、AD及质量规范写可判断条件;未知阈值列待决,不自行编数值}` | `{不能放行的失败、未解决风险及有权接受风险的真实来源;没有认可则如实待补}` | `{缺陷修复验证、受影响用例、相关既有行为及需要的新证据}` |
|
|
216
|
+
|
|
217
|
+
必需用例失败、证据过期、条件缺失、执行被阻断或尚未执行都不能算通过。模拟或局部结果不能替代本次要求的真实集成、完整范围或必要人类验收。明确缺陷处置、重测触发和回归选择依据;修复导致需求或设计变化时先更新对应引用,不能通过降低判据关闭缺陷。以上定义预期和放行口径,实际结果及风险接受事件仍保存到运行报告,不在本模板预填通过状态。
|
|
218
|
+
|
|
219
|
+
## 8. 测试报告合同:一份用例集,多次运行
|
|
220
|
+
|
|
221
|
+
测试报告另存于能力目录的实际报告位置,按项目登记解析;命名采用 `{PBC}-{需求主题}-TestReport_v{报告版本}.md`,不强制跟 TestCase 同号。报告版本标识文档修订,`runId` 标识一次真实运行;报告编辑不伪造新运行,重测产生的新运行不覆盖前次失败。
|
|
222
|
+
|
|
223
|
+
### 8.1 报告必须记录的事实
|
|
224
|
+
|
|
225
|
+
| 报告字段 | 执行后记录要求 |
|
|
226
|
+
| --- | --- |
|
|
227
|
+
| 报告身份与运行 | `{报告ID/版本、runId、实际起止时间、执行主体、实际工具/运行方式}` |
|
|
228
|
+
| 本次选择 | `{capabilityId/prdId;PRD/AD/TestCase准确版本、固定内容及摘要;多主题组合逐项登记}` |
|
|
229
|
+
| 本次组合 | `{§6.1组合ID;提供/消费方文档、契约、数据、代码/服务及环境各自版本;设计配套与真实兼容分开}` |
|
|
230
|
+
| 实际候选 | `{源提交、构建/镜像制品、摘要;实际启动/部署对象,未部署不能写已部署}` |
|
|
231
|
+
| 实际环境 | `{配置、依赖、身份/权限、数据版本及来源、真实/模拟边界;不泄露密钥}` |
|
|
232
|
+
| 实际测试策略 | `{实际框架/工具及版本、配置和测试目录、运行层级;适用覆盖测量的口径、条件、结果及原始报告,未测不填数值}` |
|
|
233
|
+
| 用例及子场景 | `{实际运行的TC/参数/复合子项及脚本/样本版本}` |
|
|
234
|
+
| 原始执行与证据 | `{实际命令/操作、退出结果、请求/响应、日志、截图、数据核查、测量;可定位原始记录}` |
|
|
235
|
+
| 逐项结果 | `{通过/失败/阻断/未执行及具体原因;各子项不得合并隐藏}` |
|
|
236
|
+
| 实际副作用与恢复 | `{允许及意外变化、清理/回滚是否完成、未恢复影响}` |
|
|
237
|
+
| 缺陷与偏差 | `{稳定缺陷ID、复现条件、严重性及影响范围;不暗改预期以适应实现}` |
|
|
238
|
+
| 汇总与适用限制 | `{已验证/未验证对象和范围、残余风险、可接受依据;不能只给总通过率}` |
|
|
239
|
+
| 审查/业务验收 | `{按需的真实参与者、版本范围、可信记录;没认可写未取得}` |
|
|
240
|
+
|
|
241
|
+
以上是未来报告字段约束,不是本模板已经执行的结果。执行前最多登记运行计划和“未执行”,不能预造 runId 的成功、用户签字或证据文件。一次交付汇总多个真实运行时保留各运行明细、失败和未执行记录,不只挑最后一次绿色结果。
|
|
242
|
+
|
|
243
|
+
### 8.2 失败、重测与完成规则
|
|
244
|
+
|
|
245
|
+
- 失败先保存原始证据和缺陷;修复后绑定新候选与受影响用例重测,并按影响选择回归。
|
|
246
|
+
- 输入、代码、配置、数据、依赖或环境改变时复核相关证据,不能让旧通过自动证明新对象;无关变动不粗暴重跑全部。
|
|
247
|
+
- 文件或 JSON 存在不能证明真实运行发生。静态检查、单元夹具、浏览器、真实服务、人类认可分层记录。
|
|
248
|
+
- 通过用例、完整产品交付、业务收益、发布就绪、发布授权和部署回执分别判断;测试报告不替代生产放行。
|
|
249
|
+
|
|
250
|
+
## 9. 开放问题与交接
|
|
251
|
+
|
|
252
|
+
| 问题 ID | 不可判断的预期/条件及来源 | 受影响用例/子项 | 可继续部分 | 返回 PRD/AD/原型/环境责任方 | 实际关闭依据 |
|
|
253
|
+
| --- | --- | --- | --- | --- | --- |
|
|
254
|
+
| `{稳定ID}` | `{区分事实、假设与冲突}` | `{明确范围}` | `{独立工作}` | `{具体位置或未指定}` | `{真实答复/验证,未取得则待处理}` |
|
|
255
|
+
|
|
256
|
+
### 完成核对
|
|
257
|
+
|
|
258
|
+
- PRD 直接覆盖与 AD 工程覆盖均完整,复合子项、跨主题交接及必要回归未漏。
|
|
259
|
+
- 每个用例九要素明确,允许/禁止副作用可判定,阈值和预期有来源。
|
|
260
|
+
- 所需环境/数据与实际可用状态分开,替身不冒充真实集成。
|
|
261
|
+
- 框架/工具版本、测试目录、层级和适用覆盖要求明确,与 AD 命令/cwd 及项目质量权威一致;未安装、未执行及不适用范围如实登记。
|
|
262
|
+
- 规格可交接、执行可准入、实际运行、业务认可分别记录,无循环开工条件。
|
|
263
|
+
- 报告字段和1:N运行关系明确,未执行不预填通过;旧证据和失败记录保留。
|
|
264
|
+
- §0.2、§3.3、§6.1—§6.4中的准确组合、唯一权威、失败恢复、传递影响和无关主题保护有实际来源。
|
|
265
|
+
- §7.1不把完整TestCase设为所有Plan的前置;原test/Build仍执行TDD,原代码review与零写入文档审查职责分开。
|
|
266
|
+
|
|
267
|
+
交接结论:`{本次可供Plan采用的验证要求、尚不能确定的判据和影响;实际执行须另行准入。当前版本及真实认可范围如实记录。}`
|
|
268
|
+
|
|
269
|
+
版本变化:`{变化来源、修改用例/子项、受影响需求/AD/执行任务及报告适用性;保留旧版本与重新采用依据。}`
|