@givolt/i3-composer-agent 3.1.0 → 3.2.1

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.
Files changed (86) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude/commands/i3-sop.md +3 -3
  3. package/.claude-plugin/marketplace.json +1 -1
  4. package/.claude-plugin/plugin.json +1 -1
  5. package/.codex-plugin/plugin.json +1 -1
  6. package/.gemini/commands/i3-sop.toml +3 -3
  7. package/README.md +22 -27
  8. package/commands/i3-sop.toml +3 -3
  9. package/docs/codex-setup.md +1 -1
  10. package/docs/other-hosts.md +1 -1
  11. package/docs/workbuddy-setup.md +1 -1
  12. package/evals/cases/i3-enterprise-sop.json +70 -32
  13. package/evals/zh-CN/cases/i3-enterprise-sop.json +77 -31
  14. package/package.json +1 -23
  15. package/plugin.json +1 -1
  16. package/skills/i3-enterprise-sop/SKILL.md +151 -91
  17. package/skills/i3-enterprise-sop/references/engineering-skeleton/directory-standard.md +29 -15
  18. package/skills/i3-enterprise-sop/references/handoff.py +171 -100
  19. package/skills/i3-enterprise-sop/references/read_text.py +60 -0
  20. package/skills/i3-enterprise-sop/references/technical-baseline/baselines/enterprise-application-technical-baseline-v0-0-4.md +28 -28
  21. package/skills/i3-enterprise-sop/references/technical-baseline/readme.md +9 -118
  22. package/skills/i3-enterprise-sop/references/{ad/templates → templates}/ad.md +34 -27
  23. package/skills/i3-enterprise-sop/references/{brd/templates → templates}/brd.md +21 -10
  24. package/skills/i3-enterprise-sop/references/{prd/templates → templates}/prd.md +57 -24
  25. package/skills/i3-enterprise-sop/references/{testcase/templates → templates}/testcase.md +32 -22
  26. package/docs/upstream-repository/AGENTS.md +0 -92
  27. package/docs/upstream-repository/CLAUDE.md +0 -60
  28. package/docs/upstream-repository/CONTRIBUTING.md +0 -137
  29. package/docs/upstream-repository/README.md +0 -8
  30. package/docs/upstream-repository/gitattributes.txt +0 -1
  31. package/docs/upstream-repository/gitignore.txt +0 -10
  32. package/docs/upstream-repository/manifest.json +0 -71
  33. package/docs/upstream-repository/opencode-skills.link +0 -1
  34. package/docs/upstream-repository/skill-gap.yml +0 -80
  35. package/docs/upstream-repository/skills-contributing.md +0 -15
  36. package/docs/upstream-repository/test-plugin-install.yml +0 -167
  37. package/skills/i3-enterprise-sop/references/ad/assets-manifest.json +0 -86
  38. package/skills/i3-enterprise-sop/references/ad/prompts/01-generate.md +0 -58
  39. package/skills/i3-enterprise-sop/references/ad/prompts/02-review.md +0 -54
  40. package/skills/i3-enterprise-sop/references/ad/prompts/03-revise.md +0 -54
  41. package/skills/i3-enterprise-sop/references/ad/prompts/04-recheck.md +0 -54
  42. package/skills/i3-enterprise-sop/references/ad/readme.md +0 -70
  43. package/skills/i3-enterprise-sop/references/assets-manifest.json +0 -230
  44. package/skills/i3-enterprise-sop/references/brd/assets-manifest.json +0 -83
  45. package/skills/i3-enterprise-sop/references/brd/prompts/01-generate.md +0 -51
  46. package/skills/i3-enterprise-sop/references/brd/prompts/02-review.md +0 -47
  47. package/skills/i3-enterprise-sop/references/brd/prompts/03-revise.md +0 -47
  48. package/skills/i3-enterprise-sop/references/brd/prompts/04-recheck.md +0 -47
  49. package/skills/i3-enterprise-sop/references/brd/readme.md +0 -50
  50. package/skills/i3-enterprise-sop/references/codebuddy-project-guide.md +0 -34
  51. package/skills/i3-enterprise-sop/references/controlled-handoff.md +0 -41
  52. package/skills/i3-enterprise-sop/references/controlled_handoff.py +0 -379
  53. package/skills/i3-enterprise-sop/references/engineering-skeleton/adoption.md +0 -200
  54. package/skills/i3-enterprise-sop/references/engineering-skeleton/catalog.json +0 -17
  55. package/skills/i3-enterprise-sop/references/engineering-skeleton/readme.md +0 -52
  56. package/skills/i3-enterprise-sop/references/handoff-contract.md +0 -196
  57. package/skills/i3-enterprise-sop/references/lifecycle-contract.md +0 -91
  58. package/skills/i3-enterprise-sop/references/plan-handoff.md +0 -73
  59. package/skills/i3-enterprise-sop/references/prd/assets-manifest.json +0 -109
  60. package/skills/i3-enterprise-sop/references/prd/prompts/01-generate.md +0 -64
  61. package/skills/i3-enterprise-sop/references/prd/prompts/02-review.md +0 -49
  62. package/skills/i3-enterprise-sop/references/prd/prompts/03-revise.md +0 -48
  63. package/skills/i3-enterprise-sop/references/prd/prompts/04-recheck.md +0 -47
  64. package/skills/i3-enterprise-sop/references/prd/readme.md +0 -137
  65. package/skills/i3-enterprise-sop/references/prd/template-contracts.md +0 -39
  66. package/skills/i3-enterprise-sop/references/prd/templates/ad.md +0 -17
  67. package/skills/i3-enterprise-sop/references/readme.md +0 -167
  68. package/skills/i3-enterprise-sop/references/recovery-contract.md +0 -65
  69. package/skills/i3-enterprise-sop/references/review-handoff.md +0 -105
  70. package/skills/i3-enterprise-sop/references/selection-handoff.md +0 -55
  71. package/skills/i3-enterprise-sop/references/selection_handoff.py +0 -225
  72. package/skills/i3-enterprise-sop/references/stages.json +0 -271
  73. package/skills/i3-enterprise-sop/references/technical-baseline/assets-manifest.json +0 -84
  74. package/skills/i3-enterprise-sop/references/template-contracts.md +0 -142
  75. package/skills/i3-enterprise-sop/references/testcase/assets-manifest.json +0 -91
  76. package/skills/i3-enterprise-sop/references/testcase/prompts/01-generate.md +0 -53
  77. package/skills/i3-enterprise-sop/references/testcase/prompts/02-review.md +0 -51
  78. package/skills/i3-enterprise-sop/references/testcase/prompts/03-revise.md +0 -49
  79. package/skills/i3-enterprise-sop/references/testcase/prompts/04-recheck.md +0 -51
  80. package/skills/i3-enterprise-sop/references/testcase/readme.md +0 -61
  81. package/skills/i3-enterprise-sop/references/verification/check_execution.py +0 -185
  82. package/skills/i3-enterprise-sop/references/verification/check_native_execution.py +0 -282
  83. package/skills/i3-enterprise-sop/references/verification/check_reads.py +0 -348
  84. package/skills/i3-enterprise-sop/references/verification/readme.md +0 -149
  85. package/skills/i3-enterprise-sop/references/verification/review-output.schema.json +0 -155
  86. package/skills/i3-enterprise-sop/references/verification/review_handoff.py +0 -329
@@ -1,64 +0,0 @@
1
- # PRD 生成任务
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
- 此提示词是提供给现有 `i3-spec-driven-development` 的企业任务说明。它不新增技能、命令或自动调度。通过已启用项目指引定位到本文件后,模型从实际读取的项目采用记录、选定清单及业务材料补齐任务卡;用户不必逐项填写路径。仅在材料缺失、存在歧义、真实冲突或覆盖风险时澄清,不猜路径或业务答案。未明确选择企业 SOP 时不应用本提示词。
17
-
18
- ## 本次任务卡(模型据已读材料整理,缺口向调用者澄清)
19
-
20
- - 任务:只起草一个 PBC 的一个 PRD 主题。
21
- - EBC / PBC:`{capabilityId、名称、边界的实际确认状态}`。
22
- - PRD:`{稳定 prdId、需求主题、独立业务版本}`。
23
- - 唯一输出:`{项目内完整目标路径}`。
24
- - 输出约定依据:`{实际已读的项目根README或其明确引用条目,目录及文件名约定;无约定则说明拟建,不伪称已有}`。
25
- - 文件名占位符对照:`{按项目实际命名式逐项列:PBC名称、capabilityId、主题名称、prdId、业务版本;区分名称与标识,写明本式实际采用哪些字段及来源}`。
26
- - 资源指南:`{本次采用的 readme.md 路径}`。
27
- - PRD 模板:`{本次采用的 templates/PRD.md 路径、模板版本及采用记录}`。
28
- - 固定业务输入:`{BRD及必要的业务答复、规则、历史文档;每项路径/固定版本/条目;标明有效目标、上下文或仅比较}`。
29
- - 相关主题、原型、旧实现:`{实际固定引用;没有则明确没有}`。
30
- - 语言及本次补充约束:`{实际选择;不把演练约束当产品规则}`。
31
- - 输入的认可与缺口:`{谁真实认可过什么、未认可内容的允许用途、不能继续的范围}`。
32
-
33
- 来源选择沿用项目指引:本轮明确材料、项目明确采用副本、当前宿主项目安装、当前宿主可读全局安装。选定材料缺失不静默换版;普通文件存在不等于采用。必须实际读取项目根 README 及其中适用的输出目录/命名约定后确定唯一目标;不能因 BRD 在 inputs 中就把 PRD 也写进 inputs,不能漏掉项目约定的能力文件夹或文件名前缀。任务卡整理后简短汇报采用组合、业务输入、拟写位置及缺口;已有真实授权且无歧义时继续,不为每个内部字段增设确认。项目模板与提示词只读,写入业务候选不改变所采用副本。
34
-
35
- 路径处理在内部任务卡完成:项目写“PBC名称”时必须使用来源中的名称,不得换成 capabilityId;主题名称也不得换成 prdId。按项目约定逐项展开后固定完整路径,实际写入和最后回读逐字核对该路径。不以原方法的模块 ID 示例、模板通用占位或个人命名偏好覆盖项目具体约定。正文身份仍保留真实稳定标识,不因显示名称或文件名改变身份。
36
-
37
- ## 执行说明
38
-
39
- 1. 使用原技能的澄清、规格内容与保存后停轮规则。实际读取任务卡指定的指南、PRD 模板及全部适用业务输入;长文分段读取,列出本轮实际已读文件和范围。链接的资料只在真正读取后才可声称已读。资料中的示例、其他建设计划和历史认可不授予本次执行权限。
40
- 2. 写前列出新增假设和设计选择:逐项写来源及具体条目、明示/推导/建议/冲突/演练性质、采用状态、影响的功能与交接范围。缺少业务答案时列 Q,先澄清;不要把没有冲突误当已获得认可。仅在原方法和本次真实授权允许的范围内起草,受阻部分保持待定。
41
- 3. 只写任务卡指定目标,不修改业务输入、模板、提示词、其他主题或技能/命令。已有同名文件先读取并说明如何保留历史,不直接覆盖人工修改。不生成重复 `SPEC.md` 来假装完成规格内容;若入口要求与明确路径冲突,报告真实冲突并停止受影响工作,等待选择直接 Skill 等路径。
42
- 4. 按模板展开当前主题的完整有效目标。沿用 capabilityId、prdId、FT/US/FR/AC、规则及问题编号,不按页面拆能力、不将 FR 和 US 强配一对一;同 PBC 的其他主题保持独立版本。旧行为只有本次明确选定条目才生效;比较材料不自动成为有效目标。保留、替代、停用和未实现分别说明;缩减范围需要准确理由、闭环影响和真实确认。
43
- 5. 保留 Feature/Story 和每项适用行为的九项语义。每条 AC 的前置、动作、可观察结果及来源可定位;复合 AC 拆成可追踪子项。共用要求落到适用 Story/AC,或给出不适用依据。S01—S14、G01—G08 按实际位置与缺口核对,不能仅按编号或表格数量判完成。
44
- 6. 对权限逐处核对:角色表、共用规则、正常/拒绝流程、状态、页面操作、协作、AC 与 Q 使用同一条件。尤其检查多角色组合、对象归属、状态与例外、只读和写权限、决定和代记结果的区别;来源未授予的动作不得默认开放。产品规则未定时明确 Q,不交给 AD 或编码随意选择。
45
- 7. 字段的生成、存储、展示、可编辑、必填及校验条件分开表达;不把系统生成的属性自动变成页面必显或用户必填。校验/权限拒绝、明确技术失败和提交结果未知分开;成功、失败、重复请求、取消、历史记录和跨主题副作用的表现必须有依据。未知重试或审计策略先列问题,不自行承诺。
46
- 8. 最终稿每条新增规范性要求逐条回查来源,检查原意、条件、例外和要求强度;推导或建议保持标记。全文表格逐行核对表头列数及列义,防止内容落入相邻列;不可用总行数、关键词命中或自称检查代替实际核对。
47
- 9. 最后一次写入/修改后实际回读最终目标,复核来源、权限、AC、表格与受影响引用;后续若再修改,须在最后一次修改后重新分段完整回读最终目标,不能只回读局部。声明哪些核查实际执行、哪些未验证,不把本轮补读追认成过去已读。
48
- 10. 汇报目标路径、文档身份/版本、实际输入和采用情况、自查结果、Q 及具体受阻范围。请求人工审阅并结束当前轮。不得自动进入原型、AD、TestCase、Plan、Build 或发布;本份 PRD 不等于原 SPEC 六项齐备、业务认可或开发准入。
49
-
50
- ## B05 生命周期与必要读取
51
-
52
- 按选定资源索引实际读lifecycleContract及共用模板/交接合同;先列本次必读路径和用途,实际核所选正文及必要依赖,未读/失败/部分读照实。只加载本次generate动作,不加载其他动作或低优先级源兜底。
53
-
54
- 保持主题、FR/AC身份和完整当前目标;明确新增/修改/保留/撤销及真实来源,部分撤销不删整个主题,已实现事实不因目标撤销消失。
55
-
56
- 只写本次明确文档目标,先读现稿与人工修改并保留历史;最后编辑后实际回读。JSON、Plan、任务、代码和生产不是本次写入范围;生成文档后展示路径并交审,不自动登记JSON;用户明确选用后才登记selected,原方法停轮仍保持。
57
-
58
- 当前目标、任务与已实现事实分开;已完成任务保留,未实施取消不记完成,进行中保留真实工作,已实现退役通过新任务。原Plan/Build实际消费须按本轮证据核验,JSON最小辅助已提供但不在本次文稿写入权限内,不自动下阶段、工程、提交或发布。
59
-
60
- ## B05-r2 最后修改后的全文回读
61
-
62
- 全部Write/Edit结束后,必须使用读取工具分段完整覆盖最终目标正文,超出工具截断就续读剩余段。已全文读过但之后又Edit时,须再次完整覆盖最终稿,不能只回读改动行并声称“末次修改后全文已核”。本次必要输入清单中仍有未读/失败/部分读时,先报告准确缺口,不写成已全部读取;补读不是过去已读。
63
-
64
- 未完成收尾就保留实际稿和未核范围,不删除稿件、不补造通过,不登记为已完成回读的完整候选。收尾不改写业务决定,不自动进入下一阶段;只读review/recheck依然零项目写入。
@@ -1,49 +0,0 @@
1
- # PRD 独立只读审查任务
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
-
15
- ## 本次任务卡(模型据已读材料整理,缺口向调用者澄清)
16
-
17
- 仅在本轮明确企业 SOP 审查或适用的项目选择下使用。从项目指引与实际采用记录定位本主题精确候选、业务来源、模板及清单所指的审查提示词;用户不必逐项提供路径。多个候选版本无法确定、采用材料缺失或来源不可读时先澄清,不按最大版本猜测或静默换回发行模板。只读输出报告,不自行写项目、保存报告或改采用记录。会话输出可由调用者另存。
18
-
19
- - 精确候选:`{路径、documentId、prdId、业务版本、固定快照/摘要}`。
20
- - 本次指南与模板:`{明确路径/采用版本/项目修改记录}`。
21
- - 原始业务依据:`{BRD及答复、规则、历史有效内容;固定路径与条目}`。
22
- - 本次允许使用的其他证据:`{如实际读取轨迹/历史发现;未提供的不能假设}`。
23
- - 审查范围与限制:`{完整主题或明确局部;未提供的工程/服务/原型等}`。
24
- - 审查报告位置:`{由调用者保存只读输出的位置;审查者不自行写项目}`。
25
-
26
- ## 执行说明
27
-
28
- 1. 全程只读,不修改候选、来源、模板、提示词或项目设置。先实际读取指南、模板和业务来源,再逐段读取精确候选;列明实际文件与已读范围,未读或拿不到的内容列为未核实。不得把作者摘要、自查勾选或工具成功退出当作来源已完整读取的证据。
29
- 2. 建立“最终规范性断言→确切来源条目”的核查。逐条验证动作、数据、权限、阈值、默认值、例外、时点、保留和副作用:原文是否明示、是否只是推导/建议、是否扩大强度、是否遗漏限制;案例示意不能变业务要求。检查模板新增项是否误混为业务事实。
30
- 3. 核对一个 PBC 多主题的独立 prdId/版本、完整有效目标及单一权威正文,旧编号/替代/停用关系、Feature/Story、九项语义、复合 AC 子项、共用规则到行为与 AC 的落实、S01—S14 和 G01—G08 的实际证据。未知规则应有 Q 和具体受阻范围;范围减少不能仅靠作者解释视为获准。
31
- 4. 做跨位置权限核对:角色表、业务规则、流程、状态、页面、协作、AC 和 Q。用角色并集、对象归属、租户/组织、状态及特殊例外构造反例;核“禁止/允许”的副作用是否一致。只读不意味着可改,能处理不意味着可代填或复核。
32
- 5. 核系统生成/保存/展示/可编辑/必填条件;明确拒绝、技术失败、结果未知、重复/并发、取消与重试的区别,成功与拒绝的业务历史不能混写。核跨主题闭环、已知依赖/冻结/联调时点与回归影响;计划、未实现和已就绪不能混同。
33
- 6. 对全文每个表格逐行核对表头列数和内容列义;再查完整引用和稳定 ID。既查少列/多列,也查列数正确但语义错位;说明实际检查范围,不能只报告自动脚本通过。
34
- 7. 发现用稳定 ID(如 `R01`)登记:严重程度、精确位置、来源原文位置、确定矛盾或未核实、可复现反例/影响、最小修订建议。确定错误、缺少证据、可选建议分别列;无真实问题时如实零项,不能为完成流程制造发现。不要替业务方回答 Q 或发明规则来解决矛盾。
35
- 8. 报告结论只用“可交人工审阅”“需修订”或“无法判断”,附每项依据、已读范围、未核实与开放问题。原方法有自己的评级时同时保留其原意,不自称业务认可、规格准入或发布通过。即使必修为零,也保留建议、Q、未执行测试和人工审阅边界;报告后结束本轮。
36
-
37
- ## B05 生命周期与必要读取
38
-
39
- 生命周期、模板及交接合同的实质条款按[统一审查约定](../../review-handoff.md)核对;外层解析并保护原索引/合同,未知自改继续完整读本次选定原件;先列本次必读路径和用途,实际核所选正文及必要依赖,未读/失败/部分读照实。只加载本次review动作,不加载其他动作或低优先级源兜底。
40
-
41
- 保持主题、FR/AC身份和完整当前目标;明确新增/修改/保留/撤销及真实来源,部分撤销不删整个主题,已实现事实不因目标撤销消失。
42
-
43
- 本次独立只读,仅会话标注问题/来源/影响/最小建议;不改候选、JSON、Plan、代码或报告。人工可修订、有据不采纳或保留Q;原代码review不由此变成只读。
44
-
45
- 当前目标、任务与已实现事实分开;已完成任务保留,未实施取消不记完成,进行中保留真实工作,已实现退役通过新任务。原Plan/Build实际接点和JSON辅助仍待后续,不自动下阶段、工程、提交或发布。
46
-
47
- ## B05收口:单项目审查证据
48
-
49
- 一次只审本次明确的业务项目/主题;必要跨主题来源仍按影响读取。对每条发现和已核事实分别给目标及来源的实际路径、起止行和短原文摘录,再给理由、反例与最小建议。最终会话按统一审查约定和外层传入的同源Schema输出findings、checkedFacts、verdict和未核范围;不能把成功Read一次当读完,不自报未读输入已核。摘录/读取检查通过仍不证明语义结论成立,误报保留反证,不自动改稿。
@@ -1,48 +0,0 @@
1
- # PRD 修订任务
2
-
3
- <!-- i3:zh-guide:start -->
4
- ## 中文使用说明
5
-
6
- 按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
7
-
8
- 默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
9
- <!-- i3:zh-guide:end -->
10
-
11
- 只修订明确指定的候选。修订流程不授予业务批准,也不意味着旧发现都正确。
12
-
13
- ## 本次任务卡(模型据已读材料整理,缺口向调用者澄清)
14
-
15
- 仅在本轮明确企业 SOP 修订或适用的项目选择下使用。按项目指引及实际采用记录定位精确目标、选定模板、来源和审查报告;用户不必逐项提供路径。多个版本无法确定、报告尚未固定或采用材料缺失时报告具体缺口,不猜测,不覆盖项目自改模板、提示词或人工内容。任务卡整理后沿用真实授权范围,不为已明确字段重复询问。
16
-
17
- - 唯一目标:`{完整路径、documentId/prdId/业务版本及当前草稿摘要}`。
18
- - 已保留的修订前历史:`{固定副本路径/摘要;尚无副本时先与调用者落实保存方式}`。
19
- - 审查报告:`{精确文件/固定输出及稳定发现 ID}`。
20
- - 人工修改与答复:`{实际记录;没有则注明}`。
21
- - 固定来源、指南与模板:`{本次采用的精确路径/版本/条目}`。
22
- - 本次输出要求:`{只改唯一目标;逐项回应报告由调用者另存}`。
23
-
24
- ## 执行说明
25
-
26
- 1. 实际读取目标当前稿、历史保留记录、报告、相关来源及人工修改。没有修订前可回读副本先停止覆盖,由调用者保存。只写唯一目标,不改来源、模板、其他主题、技能或命令;不得覆盖没有读取的人工修改。
27
- 2. 写前逐项列“发现 ID→是否成立→来源/理由→最小改动→受影响行为、AC、Q和交接”。正确的发现修复;误报给出证据;需要业务选择的内容保持待决。新增假设及设计选择先披露性质和影响,不为了清零而补造指标、权限或关闭 Q。
28
- 3. 保持能力/主题/条目身份及有效目标。尚未采用草稿的审查修订与已采用业务版本变更分开:不机械升版本、不改主题身份;已有真实采用或版本约束时按其记录执行。缩减范围仍需实际决定和影响分析,不能当作普通文案修正。
29
- 4. 同一问题修复到全部相关位置:角色、规则、流程、状态、页面、协作、AC、追溯与 Q。检查多角色条件/例外、字段生成/存储/展示/编辑、拒绝/失败/未知、历史及跨主题副作用;原规范性要求不能因局部修复被丢失。
30
- 5. 逐项回应稳定发现 ID,说明实际改动位置、来源及剩余问题。后补来源的读取是本轮证据,不能把过去未经读取或核实的内容改写成“当时已完整读取”。保留真实审查和修订历史;来源未明确的推导保持候选。
31
- 6. 最后一次 Edit/Write 后实际回读最终目标和受影响上下文:新增规范性要求逐条回查来源;全文逐表逐行核列数和列义;S01—S14/G01—G08、引用与 AC 重新核对。若回读后再改动,按收尾规则再次完整回读最终稿,并重核受影响的来源与检查。
32
- 7. 汇报修订目标、实际读取范围、逐发现处理、未关闭问题及影响。请求独立复查和人工审阅后结束。不得自行宣布业务认可或自动进入后续阶段。
33
-
34
- ## B05 生命周期与必要读取
35
-
36
- 按选定资源索引实际读lifecycleContract及共用模板/交接合同;先列本次必读路径和用途,实际核所选正文及必要依赖,未读/失败/部分读照实。只加载本次revise动作,不加载其他动作或低优先级源兜底。
37
-
38
- 保持主题、FR/AC身份和完整当前目标;明确新增/修改/保留/撤销及真实来源,部分撤销不删整个主题,已实现事实不因目标撤销消失。
39
-
40
- 只写本次明确文档目标,先读现稿与人工修改并保留历史;最后编辑后实际回读。JSON、Plan、任务、代码和生产不是本次写入范围;生成文档后展示路径并交审,不自动登记JSON;用户明确选用后才登记selected,原方法停轮仍保持。
41
-
42
- 当前目标、任务与已实现事实分开;已完成任务保留,未实施取消不记完成,进行中保留真实工作,已实现退役通过新任务。原Plan/Build实际接点和JSON辅助仍待后续,不自动下阶段、工程、提交或发布。
43
-
44
- ## B05-r2 最后修改后的全文回读
45
-
46
- 全部Write/Edit结束后,必须使用读取工具分段完整覆盖最终目标正文,超出工具截断就续读剩余段。已全文读过但之后又Edit时,须再次完整覆盖最终稿,不能只回读改动行并声称“末次修改后全文已核”。本次必要输入清单中仍有未读/失败/部分读时,先报告准确缺口,不写成已全部读取;补读不是过去已读。
47
-
48
- 未完成收尾就保留实际稿和未核范围,不删除稿件、不补造通过,不登记为已完成回读的完整候选。收尾不改写业务决定,不自动进入下一阶段;只读review/recheck依然零项目写入。
@@ -1,47 +0,0 @@
1
- # PRD 独立只读复查任务
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
-
15
- ## 本次任务卡(模型据已读材料整理,缺口向调用者澄清)
16
-
17
- 仅在本轮明确企业 SOP 复查或适用的项目选择下使用。按项目指引及实际采用记录定位精确修订稿、原审查、逐项回应、业务来源和模板;用户不必逐项提供路径。多个版本或发现集无法对应时澄清,不按时间或最大版本号猜测。保持独立新上下文和全程只读,报告由调用者另存,不自行写项目或更新采用记录。
18
-
19
- - 精确修订稿:`{路径、身份/版本、固定快照/摘要}`。
20
- - 旧稿与原审查:`{固定副本、报告及稳定发现 ID}`。
21
- - 修订说明:`{逐发现回应的固定输出/记录}`。
22
- - 真实来源、采用指南与模板:`{精确路径/版本/必要条目}`。
23
- - 复查范围及未提供证据:`{实际范围;测试、工程或业务认可缺口}`。
24
- - 报告保存:`{调用者另存位置;复查者不写项目}`。
25
-
26
- ## 执行说明
27
-
28
- 1. 全程只读。实际读取修订稿、旧发现、修订映射及必要真实来源,不能仅看差异或作者摘要。列明实际已读范围,未读与缺少证据如实记录;来源性质、采用与业务认可不能混同。
29
- 2. 按稳定发现 ID 分别判“已关闭/部分关闭/未关闭/无法核实”,给出修订后位置、准确来源和检验理由。复核误报的排除依据。局部改正但其他角色、流程、页面、AC或 Q 仍矛盾时不得关闭。
30
- 3. 额外检查修订引入的回归与同类问题:最终新增规范性断言逐条回查强度、条件和例外;角色组合与对象/状态权限、字段显示与生成、拒绝/失败/结果未知、重试与业务历史一致。保留完整有效目标、身份、编号和来源范围,防止修复造成遗漏。
31
- 4. 全文逐表逐行核列数及列义;核九项行为、复合 AC、共用规则到行为/AC、S01—S14/G01—G08、依赖和未决影响的实际位置。未经独立核实的部分不能用总数、关键词或作者勾选掩盖。
32
- 5. 新问题使用新的稳定 ID,说明确定矛盾/未核实/建议、精确位置、来源、反例影响及最小建议。不虚构发现,也不自行决定缺失业务规则。
33
- 6. 输出“可交人工审阅/需修订/无法判断”,逐项状态、剩余 Q/建议、实际检查和未执行事项。必修为零不等于所有 Q 已关闭、真实业务测试通过、原 SPEC 六项齐备或用户已批准。保留原方法的认可与停轮要求,结束本轮。
34
-
35
- ## B05 生命周期与必要读取
36
-
37
- 生命周期、模板及交接合同的实质条款按[统一审查约定](../../review-handoff.md)核对;外层解析并保护原索引/合同,未知自改继续完整读本次选定原件;先列本次必读路径和用途,实际核所选正文及必要依赖,未读/失败/部分读照实。只加载本次recheck动作,不加载其他动作或低优先级源兜底。
38
-
39
- 保持主题、FR/AC身份和完整当前目标;明确新增/修改/保留/撤销及真实来源,部分撤销不删整个主题,已实现事实不因目标撤销消失。
40
-
41
- 本次独立只读,仅会话标注问题/来源/影响/最小建议;不改候选、JSON、Plan、代码或报告。人工可修订、有据不采纳或保留Q;原代码review不由此变成只读。
42
-
43
- 当前目标、任务与已实现事实分开;已完成任务保留,未实施取消不记完成,进行中保留真实工作,已实现退役通过新任务。原Plan/Build实际接点和JSON辅助仍待后续,不自动下阶段、工程、提交或发布。
44
-
45
- ## B05收口:单项目审查证据
46
-
47
- 一次只审本次明确的业务项目/主题;必要跨主题来源仍按影响读取。对每条发现和已核事实分别给目标及来源的实际路径、起止行和短原文摘录,再给理由、反例与最小建议。最终会话按统一审查约定和外层传入的同源Schema输出findings、checkedFacts、verdict和未核范围;不能把成功Read一次当读完,不自报未读输入已核。摘录/读取检查通过仍不证明语义结论成立,误报保留反证,不自动改稿。
@@ -1,137 +0,0 @@
1
- # 企业 SOP · PRD 资源切片
2
-
3
- <!-- i3:zh-guide:start -->
4
- ## 中文使用说明
5
-
6
- 按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
7
-
8
- 默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
9
- <!-- i3:zh-guide:end -->
10
-
11
- 当前子包版本:0.3.3;模板内容版本沿本阶段manifest,正文不改。下文B05等旧版本文字保留为历史说明。
12
-
13
- 审查加载分支:review/recheck完整读取本README、完整模板、唯一动作、实际业务与采用约束,依[统一审查约定](../review-handoff.md)由外层解析元数据并保留变化核对。下文涉及整套共用文件的加载要求在这两个动作按该分支理解;未知自改组合完整读选定原件,其余作业及实质条款保持。
14
-
15
- 本切片提供 PRD v0.0.4 固定模板、四阶段任务提示词及使用说明,用“原命令或原 Skill+本次明确任务+实际采用模板”制作一个需求主题的 PRD 候选。它是自有补充资料,不是新增 Skill、命令、Persona、自动调度或机器门禁;当前发行基线仍为 **26 Skills/10 个逻辑命令/4 Personas**,继承的原 25/9 及已确认增量不因本切片改变。
16
-
17
- 本文、合同承接页及 AD 承接页为本切片编写的说明。source 中的 [templates/PRD.md](templates/prd.md) 为自有分发模板 v0.0.4,基于设计模板 v0.0.3 清理历史迁移页的引用及说明;行为卡、AC、S01—S14 与共用 G01—G08 的有效要求全部保留,任务直接读取当前模板和合同。distribution 中的模板经过既有品牌转换流程插入标准 8 行中文指南,除此之外保留 source 模板正文;不能声称 source、distribution 和安装件的模板全链字节相同。其中“草案、待评审、未作为运行技能安装”等文字保留其来源语境。资源被打包、安装或明确选用,不自动变成业务认可或完整 3.0 交付。
18
-
19
- ## 1. 先选择材料,再开始一次文档任务
20
-
21
- 项目已启用企业资料指引时,模型可按本次明确业务任务查找采用记录、安装清单与本资源清单,自动整理下述路径和任务卡。未明确选择企业 SOP 时不采用这些企业材料;本轮标准流程要求优先。用户不必逐项输入路径,模型只对真实缺口、歧义、冲突和覆盖风险提问。项目指引随同位的企业资源入口交付,当前资源清单仍只登记本 PRD 子目录。
22
-
23
- 1. 读取随包 `assets-manifest.json`,核对模板版本、来源身份、文件摘要和适用范围。缺失或不一致时列准确缺口,不能猜测“已经安装”或“已采用”。
24
- 2. 确定真实项目根、PBC、`capabilityId`、主题 `prdId`、本次文档版本与唯一目标路径。一个 PBC 可有多个主题;主题各自演进,不能把同号文件当成同一文档或自动配套关系。
25
- 3. 选择可回读的业务来源、BRD、真实答复、前版、共享规则及适用原型;登记准确版本、条目、实际已读范围和用途。早期 PRD 不要求尚未形成的 AD/TestCase;不存在就写“未形成”。
26
- 4. 决定直接采用包内固定模板,或采用已准备好的项目副本。明确读到的模板位置、版本、来源摘要和本地修改,不能仅写“使用最新版”。
27
- 5. 按清单定位 [生成提示词](prompts/01-generate.md);模型从已读材料补齐任务卡,候选完成后结束当前轮。另用独立上下文做[只读审查](prompts/02-review.md),再由作者[修订](prompts/03-revise.md),最后[独立复查](prompts/04-recheck.md)。每次任务均需明确范围,四份提示词不自动串行执行。
28
-
29
- 真实项目可按自身约定保存 `{PBC}-{需求主题}-PRD_v0.0.1.md`。初始版本只是示例;不能为了套用模板改名、重编稳定 ID、伪造版本历史或覆盖已有人工内容。正文身份与准确引用优先于显示名称和文件名。
30
-
31
- ## 2. 原命令与直接 Skill 两种入口
32
-
33
- 两种入口使用同一份明确任务、业务输入、模板、输出及停点。以下英文名称是 source 入口名称;品牌化版本和不同宿主的实际显示名称、调用能力,以本次安装与发现结果为准。不要把一种宿主的安装路径或命令写法当成通用路径。
34
-
35
- | 入口 | 使用方法 | 必须核对的边界 |
36
- | --- | --- | --- |
37
- | 短命令 | 先发完整生成任务,要求核对输入、模板和拟写位置后复述并等待;然后在支持该入口的宿主单独发送 `/i3-spec` | 原命令默认根 `SPEC.md`。外部模板路径与其发生实际冲突时,列依据及影响,停止受冲突范围;不自动另造 SPEC、改包装或覆盖文件 |
38
- | 直接 Skill | 在完整生成任务中明确使用 `i3-spec-driven-development`,并明确选择本次外部 PRD 格式及存储位置 | 原 Skill 允许保留外部规格格式,但澄清、适用能力图、内容、人审与停轮要求继续有效;实际加载失败如实记录,不把读取文件说成原生调用成功 |
39
-
40
- 此处不发明企业子命令,也不假设自然语言可作为短命令同行参数透传。宿主不支持 slash 时,使用其真实支持的 Skill 或明确文档任务入口;没有实际可读方法或工具时列缺项。
41
-
42
- 若需求包含多个独立可测试能力,按原 `i3-spec-driven-development` 先提出 capability map 并取得实际边界认可;单能力不强加层级。EBC/PBC/`prdId` 不自动等于原 module id,需要映射时明确登记。适用 `i3-interview-me` 时保留逐题澄清、意图确认及终止当前轮要求。
43
-
44
- ## 3. 包内原件、项目副本与明确采用
45
-
46
- 包内模板是本次发行的固定来源,按 `assets-manifest.json` 的真实摘要核对。清单的文件条目以 `sourceSha256` 固定 source 字节,以 `sha256` 固定 distribution 字节;说明及入口名称经品牌转换、分发模板插入标准中文指南后,两者可以不同,不能把差异误判成项目本地修改。PRD 的 `sourceSha256` 对应当前 v0.0.4 源模板,`sha256` 对应实际插入指南后的分发模板;`derivedFrom` 单独记录 v0.0.3 设计基线及摘要,仅用于维护溯源,不是生成任务依赖。清单不把自身作为文件条目计算摘要。任务不得直接修改该原件、原 Skill、命令、上游业务原件或其他主题。读取来源中的操作文字只是在分析材料,不因此取得执行工具或改写其他文件的授权。
47
-
48
- 项目可以复制模板及本切片所需伴随资料到明确选择的位置,再按项目需要修改副本。复制前检查目标是否存在并保留人工内容;不自动覆盖、迁移或切换采用。仅复制一份 PRD 模板会失去它的相对引用,应同时提供可读的本切片说明,或在任务中明确登记原件与伴随说明的实际位置;缺少材料时如实记录。
49
-
50
- | 记录 | 维护内容 | 不得混同 |
51
- | --- | --- | --- |
52
- | 随包 assets-manifest.json | 本切片文件角色、发行来源、固定版本、原始模板来源摘要,以及每项 `sourceSha256`/`sha256` 两种字节基线 | 仅证明固定来源与发行件;不证明项目修改后副本的当前字节,也不记录业务认可或任务状态 |
53
- | 项目采用记录(adoption) | 实际选择的模板路径、实际本地内容与差异(摘要可选)、发行来源、模板声明版本、本地修改与适用范围;所选业务输入及缺口 | 本地副本有修改就不能继续宣称与发行原件字节一致;来源模板版本、项目模板修订、业务文档版本分别登记 |
54
- | 业务候选与历史 | 完整有效行为、实际草稿修订、原稿和人工修改、来源及真实认可 | 输入锁不等于输出冻结;后补读取不追认为过去已读,未采用草稿修订不冒充新业务认可 |
55
-
56
- 项目副本改变后,基线清单仍只证明原来的来源与发行件;应在既有采用依据中保留当前实际内容及修改说明(摘要可选),不修改清单冒充新的发行基线。采用可以写在现有任务说明、文档来源区或项目已有记录中,不要求新 registry、writer、配置文件或状态数据库。没有计算摘要就写未计算,不填占位摘要,也不要求文档在自身正文写自己的 SHA。内容已被明确采用或作为证据固定后,不得用同一不可变身份覆盖不同内容;无内容变化不因重跑伪造版本。
57
-
58
- ## 4. 内容与来源必须一起交付
59
-
60
- PRD 维护完整产品目标、范围、角色和数据范围、对象与状态、流程、页面和协作、详细行为及可测 AC。全部有效行为从 §0.3 定位唯一完整来源,§4.2 只是同一集合的目录;新增、修改、保留、替代、停用以及比较材料分别表达,不能只交差异摘要或复活旧来源中已被替代的条目。
61
-
62
- 写前公开本次新增假设或设计选择的准确来源、候选性质和影响。每项新增规范性断言都回查来源与强度,区分原文明示、来源内推导、真实确认、冲突、演练假设和待确认建议。明示不等于业务获批;推导不扩展为无源权限、状态、指标、外部系统或范围。实质业务选择不能安全保持未决时,澄清并停止依赖它的范围;无依赖部分可继续,明确限制。
63
-
64
- 角色表、业务规则、流程、页面、行为卡、AC 和问题表的权限条件必须一致。多角色组合按实际来源核对,不能仅因存在另一角色就取消已有授权,也不能把全读推成代执行;特别禁止的适用对象与时间范围同样需要来源。分别核字段生成、存储、展示、编辑,业务前提、系统必须检查及系统明确不判断;校验拒绝、无权限、技术失败、结果未知和恢复不能用一句“失败”合并。
65
-
66
- 每张表按自身表头逐行核列数与列义;复合 AC 拆出可定位子项,保留条件、例外、允许与禁止副作用。实际保存后使用可用读取工具回读;未读、读取失败、部分读取分别如实写,作者自查不能替代独立审查或人审。
67
-
68
- ### 4.1 SPEC 六项由完整规格集合承接
69
-
70
- | 原要求 | 权威承接 | 必须保留的具体内容 |
71
- | --- | --- | --- |
72
- | Objective | BRD/PRD;PRD §1、§3、§6 | 用户、问题、业务价值和可测成功条件;功能验收与真实业务收益分开 |
73
- | Commands | AD §9.1;TestCase §3.1 固定引用 | build/test/lint/dev 完整命令、参数、cwd、前提及副作用,不只列工具名 |
74
- | Project Structure | AD §3.2、§9.2 | 源码、测试、文档、适用生成物的位置及责任,拟建与已有分开 |
75
- | Code Style | AD §9.3 | 真实可定位示例,或固定规范及其实际示例、命名和格式范围 |
76
- | Testing Strategy | TestCase §2、§3.1、§5;AD §9.1、§9.5 | 框架与版本、目录、层级、命令、条件、覆盖要求及来源 |
77
- | Boundaries | AD §9.4;BRD/PRD 提供业务依据 | Always do/Ask first/Never do;保留原方法与项目工程授权边界 |
78
-
79
- AD 另承接技术栈与精确版本、字段/API/数据库、权限实施、事务、并发、迁移及恢复;TestCase 直接从选定 PRD 取产品预期,再核 AD 技术判据。实际运行结果另存 TestReport。这里的章节号是设计合同的承接定位,不表示本包已交付相应完整模板或实例;当前缺项逐项注明。
80
-
81
- 早期 PRD 可先形成业务候选;不能凭此宣称六项完整、完整 Spec 已获认可、可计划或可编码。不为补六项另造第五核心规格或强制复制一份 SPEC;标准项目已有 SPEC 及其原约定继续保留。Plan、唯一任务清单或实际指定 tracker、CONSTRAINTS、ADR、原型、正式契约、测试代码及真实报告继续按适用方法维护。
82
-
83
- ## 5. S01—S14 与 G01—G08 逐项核对
84
-
85
- 这些是内容检查编号,既不是阶段状态,也不是已实现的机器门禁。每项填写实际位置、证据、齐备/部分/缺失/不适用及理由,不能只勾总项或比较覆盖数量。[固定模板](templates/prd.md) §10.2 保留 S01—S14 完整清单;以下给出本切片使用索引。
86
-
87
- | 编号 | 必须核对的内容 | PRD 定位 |
88
- | --- | --- | --- |
89
- | S01 | 上游目标、业务假设、验证闭环、纳入及排除有来源,未知指标保持缺口 | §1/§2/§4.1 |
90
- | S02 | 每条有效行为有唯一固定完整来源;Feature/Story 与既有编号映射可追溯 | §0.3/§4.2/§6 |
91
- | S03 | 角色、前置、动作、状态、结果、拒绝/失败/未知/重复达到可原型、可测试粒度 | §6九项行为卡 |
92
- | S04 | AC 可判断、前置可构造、复合子项完整、跨卡引用可定位,测试不猜预期 | §6逐条 AC |
93
- | S05 | 规则、对象、页面只有一个权威定义,专用行为有来源 | §3/§5/§6/§7 |
94
- | S06 | 跨功能/主题闭环一致;已知执行依赖与业务问题分开,既有影响及回归输入明确 | §4.1/§4.3/§8.1/§9 |
95
- | S07 | 优先级沿用来源;必需路径降级/移出/停用有理由、闭环影响、受影响条目和真实确认 | §4.2/§0.2 |
96
- | S08 | 候选及同一问题关联保留,展开行为不把候选变成确定需求 | §0.1/§6/§9 |
97
- | S09 | 业务前提、系统检查和明确不判断事项分别表达 | §2/§3/§5/§6 |
98
- | S10 | 冲突保留双方,问题绑定行为/AC、具体受阻交接和真实关闭依据 | §9 |
99
- | S11 | 变化追到受影响行为、AC 及下游复核,旧确认不静默转移 | §0.2/§9/§10 |
100
- | S12 | 完整有效集合可定位,目标、上下文和比较分开,缺项不冒充齐备 | §0.3/§4.2 |
101
- | S13 | 产品与工程责任、原型/AD/TestCase/Plan 的分范围交接明确,保留六项及原认可 | §10.3 |
102
- | S14 | G01—G08 每项有实际位置及结果 | §0/§10 与下表 |
103
-
104
- ### 5.1 G01—G08 共用检查
105
-
106
- | 编号 | 当前必须保留的要求 |
107
- | --- | --- |
108
- | G01 | 文档、能力、主题、版本及实际位置可定位;未绑定如实写,不猜项目或主题 |
109
- | G02 | 明示、推导、真实确认、冲突、演练假设分别表达;候选不自动变确定 |
110
- | G03 | 全量核对目标、价值、角色、范围、场景、附件、质量及明确排除,不只读场景摘要 |
111
- | G04 | 输入及附件可回读,版本矛盾照录、缺附件登记、不自动取最新;真实已读范围有依据 |
112
- | G05 | 当前有效目标、上下文、比较基准及真实实现/生产现状分开;保留需求不证明代码可复用 |
113
- | G06 | 修订先读旧稿及人工修改,保留原件、理由、影响;无变化不加版本,模板/方法变化不自动重建或重放外部动作 |
114
- | G07 | 认可绑定实际修订、范围、参与者、时间及固定记录;模板、业务、开工、生产认可分别表达,不预填批准/实现/测试通过 |
115
- | G08 | 规则和执行状态各有单一权威;缺口限制具体依赖范围,不造平行状态表或任务数据库 |
116
-
117
- 沿用 FT/US/FR/AC,不假定 FR 与 US 一对一,也不为套模板重编 ID。已知依赖写双方、准确对象及版本、影响 Story/AC、冻结或决定时点、联调组织、环境/数据/权限/服务前提、责任及实际状态;未知不伪造已就绪。未获真实确认的范围缩减不能删除有效要求。
118
-
119
- ## 6. 停点、证据与本切片边界
120
-
121
- 保存规格后总结候选、开放问题和无法交接范围,请求人审并结束当前轮;后续轮取得原方法要求的真实认可,再考虑规划。审查只判断是否可交人工审阅,不能代签业务批准;修订或复查也不自动进入 Plan、Build、测试执行、提交、部署或发布。既有真实授权按原对象和范围延续,不为每份文件增设机械审批。
122
-
123
- 项目明确选择某版 PRD 时,只登记当前需要的输入;以后选 AD/TestCase 时固定各自版本及直接上游,不强制同号、不按最大版本猜组合。PRD 可提供行为/AC、执行依赖、变化和产品回归输入;交 Plan 仍需适用 AD/TestCase、工程规范、六项和原认可。原 Plan 默认 `tasks/plan.md`;任务默认 `tasks/todo.md`,或项目明确指定且真实可用的 tracker,避免双写当前状态。
124
-
125
- I1 的一个合成案例在 CodeBuddy CLI/默认模型下完成了 PRD v0.0.3 直接 Skill 的生成、独立审查、修订和复查;同轮短命令作业是 BRD,不能据此宣称新版 PRD 在两个入口及全部宿主均通过。证据只支持当次文档范围,不证明业务人审、I1 整体通过、真实系统实现或执行许可。v0.0.4 仅清理模板说明依赖,先前模型执行记录仍对应当时的 v0.0.3,不能充作 v0.0.4 的新模型执行证据。`assets-manifest.json` 的 `designSources[]` 记录合同原设计的路径、版本及摘要,`derivedFrom` 记录模板设计基线,`designEvidence` 记录 I1 来源报告与证据摘要;它们均标记 `included:false`,只供维护溯源,不随包提供,也不代表安装后可直接读取这些路径。`files` 中合同说明页的摘要只对应该说明页本身,不能当作原设计摘要。未取得并实际读取来源原件时,不声称本次已回查其内容。
126
-
127
- 本切片没有交付 BRD 模板、完整 AD 模板、TestCase 模板、业务实例、工程骨架或生成器、统一 config、研发调度 Agent、自动选版或企业 auto。`templates/AD.md` 仅说明未来工程责任。只新增资料不改变 26/10/4,不把静态检查、包内存在、宿主发现、模型执行、人工认可、安装回归或正式发行互相替代。
128
-
129
- ## B05 变更交接规则
130
-
131
- B05当时资源子包0.3.0;本次增量见收口说明,模板正文和版本保持。按[入口](../readme.md)§3列本次必要读取,实际读三份共用合同及本次唯一动作;[生命周期合同](../lifecycle-contract.md)统一新增、修改、撤销和退役,不新增命令、JSON程序或工程执行器。
132
-
133
- 保持主题、FR/AC身份和完整当前目标;明确新增/修改/保留/撤销及真实来源,部分撤销不删整个主题,已实现事实不因目标撤销消失。原方法停点、只读审查与人工空间、候选/选择/Plan边界保留,项目副本升级不覆盖人工内容。
134
-
135
- ## B05收口资源增量
136
-
137
- B05当时子包0.3.1,模板正文及版本不改。统一修订全文回读措辞、适用来源和单项目审查证据;外层校验见[说明](../verification/readme.md)。不把辅助资料/Plan统一变前置,不自动改业务稿、JSON、任务或原版方法。旧验证与历史版本按当时对象保留。
@@ -1,39 +0,0 @@
1
- # PRD 切片 · 模板与交接合同承接页
2
-
3
- <!-- i3:zh-guide:start -->
4
- ## 中文使用说明
5
-
6
- 按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
7
-
8
- 默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
9
- <!-- i3:zh-guide:end -->
10
-
11
- 本页是本切片新编写的说明桥接页,不是设计来源 `template-contracts.md` 的原样副本,也不是完整四模板合同。它为固定 PRD 原文的相对引用保留可读入口;本切片使用规则的唯一说明权威为 [README](readme.md)。原设计的路径、版本及真实摘要由随包 `assets-manifest.json` 的 `designSources[]` 登记,标记 `included:false`,仅供维护溯源,不随包提供或保证安装后路径可读。`files` 中本桥接页的摘要只对应本页,不能当作原设计摘要,也不能由同名文件推定字节相同。
12
-
13
- ## 1. 身份、范围与采用
14
-
15
- 按 README 第1、3节明确项目、`capabilityId`、`prdId`、主题独立版本、固定输入和实际模板。来源、项目副本的本地修改、业务候选及真实认可分别登记;不自动取最新版,不创建新的采用或任务状态数据库。
16
-
17
- ## 4. 内容责任
18
-
19
- PRD 维护完整产品定义和行为/AC;AD 维护工程实现,TestCase 维护验证判据,实际结果另存运行报告。具体分工见 README 第4节,AD 的当前交付边界见 [AD 承接说明](templates/ad.md)。
20
-
21
- ### 4.1 原 SPEC 六项内容的完整映射
22
-
23
- 以 README §4.1 的六项表为本切片说明权威:Objective 由 BRD/PRD 承接,Commands/Project Structure/Code Style/Boundaries 由 AD 与固定工程规范承接,Testing Strategy 由 TestCase 及 AD 承接。完整命令与参数、cwd、实际目录、真实风格示例、测试框架/层级/覆盖依据和 Always/Ask first/Never 均不能删除。早期 PRD 只登记未形成项,不据此宣称完整规格认可或规划/执行准入;不另造第五核心规格或影子 SPEC。
24
-
25
- ## 5. 实例与来源
26
-
27
- 真实输入、明示/推导/确认/冲突/演练假设、已读范围及缺口按 README 第3、4节登记。模板中的占位、状态和说明不能成为业务事实;引用材料不授予工具执行或改写其他文件的权限。
28
-
29
- ### 5.1 共用 G01—G08 内容核对
30
-
31
- 完整八项要求统一维护在 README §5.1。每项填写实际位置、证据与齐备/部分/缺失/不适用理由;PRD 的 S14 不能仅勾“已完成”。S01—S14 索引在 README 第5节,完整专用清单在 [PRD 模板](templates/prd.md) §10.2。
32
-
33
- ## 6. 交接与原方法停点
34
-
35
- 按 README 第2、6节保留原方法全部适用内容、澄清、工具、验证、人审及停轮。保存规格后结束当前轮,后续轮取得必要真实认可再规划;只读审查不代人批准,不自动 Plan/Build。原型、AD、TestCase 和 Plan 各自明确可交接内容与缺口,不把“已生成”当“已实现、已测试、可开工”。
36
-
37
- ## 7. 修订与历史
38
-
39
- 修改项目副本或业务候选前先读旧稿和人工内容,保留固定历史、理由、影响及实际重新采用记录。模板升级不自动迁移实例;不把后补读取追认为历史已读,也不重放 Git、迁移、部署等外部动作。源模板副本保持清单的 `sourceSha256` 基线;分发模板由既有流程插入标准中文指南,其余模板正文保留,实际字节按 `sha256` 核对,不把两种摘要混用。
@@ -1,17 +0,0 @@
1
- # AD 承接边界说明
2
-
3
- <!-- i3:zh-guide:start -->
4
- ## 中文使用说明
5
-
6
- 按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
7
-
8
- 默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
9
- <!-- i3:zh-guide:end -->
10
-
11
- 本页是 PRD 资源切片新编写的链接承接说明,**不是完整 AD 模板,也不是已生成的 AD 业务实例**。固定 PRD 原文对 AD 的相对引用在此说明未来工程责任;本切片没有交付完整 AD、TestCase 或工程骨架。共同规则以 [README](../readme.md) 为准,合同定位见 [模板合同承接页](../template-contracts.md) §4.1。
12
-
13
- AD 在项目以后明确授权的文档任务中,基于选定 PRD、适用原型、真实工程与固定规范,维护整体技术架构、功能架构及 ER 图,并把产品行为/AC落实到组件、UI字段、API、数据关系、服务端及对象级权限、状态、事务、并发、迁移、异常与恢复。共享定义固定一个权威来源及版本,不私改 PRD 业务规则,也不把原型模拟当真实授权实现。
14
-
15
- 原 SPEC 的 Commands、Project Structure、Code Style、Boundaries 需由实际 AD/工程规范给出可回读定义;测试策略由实际 TestCase 及 AD 承接。完整命令与参数、cwd、实际目录、真实风格示例、测试层级及覆盖依据、Always/Ask first/Never 不能只写工具名或“沿用规范”。README §4.1 列出完整映射;所述设计章节号不是本页已提供完整模板的证明。
16
-
17
- PRD 阶段尚无 AD、TestCase、工程条件或必要认可时,如实登记“未形成”及具体受阻范围,不在本页补造技术栈、字段、契约或已就绪结论。起草 PRD 不触发 AD 生成,不自动进入 Plan/Build;后续任务需明确实际模板、输入、版本、输出及授权,保留原方法停点。