@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.
- package/.agents/plugins/marketplace.json +1 -1
- package/.claude/commands/i3-sop.md +3 -3
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.gemini/commands/i3-sop.toml +3 -3
- package/README.md +22 -27
- package/commands/i3-sop.toml +3 -3
- package/docs/codex-setup.md +1 -1
- package/docs/other-hosts.md +1 -1
- package/docs/workbuddy-setup.md +1 -1
- package/evals/cases/i3-enterprise-sop.json +70 -32
- package/evals/zh-CN/cases/i3-enterprise-sop.json +77 -31
- package/package.json +1 -23
- package/plugin.json +1 -1
- package/skills/i3-enterprise-sop/SKILL.md +151 -91
- package/skills/i3-enterprise-sop/references/engineering-skeleton/directory-standard.md +29 -15
- package/skills/i3-enterprise-sop/references/handoff.py +171 -100
- package/skills/i3-enterprise-sop/references/read_text.py +60 -0
- package/skills/i3-enterprise-sop/references/technical-baseline/baselines/enterprise-application-technical-baseline-v0-0-4.md +28 -28
- package/skills/i3-enterprise-sop/references/technical-baseline/readme.md +9 -118
- package/skills/i3-enterprise-sop/references/{ad/templates → templates}/ad.md +34 -27
- package/skills/i3-enterprise-sop/references/{brd/templates → templates}/brd.md +21 -10
- package/skills/i3-enterprise-sop/references/{prd/templates → templates}/prd.md +57 -24
- package/skills/i3-enterprise-sop/references/{testcase/templates → templates}/testcase.md +32 -22
- package/docs/upstream-repository/AGENTS.md +0 -92
- package/docs/upstream-repository/CLAUDE.md +0 -60
- package/docs/upstream-repository/CONTRIBUTING.md +0 -137
- package/docs/upstream-repository/README.md +0 -8
- package/docs/upstream-repository/gitattributes.txt +0 -1
- package/docs/upstream-repository/gitignore.txt +0 -10
- package/docs/upstream-repository/manifest.json +0 -71
- package/docs/upstream-repository/opencode-skills.link +0 -1
- package/docs/upstream-repository/skill-gap.yml +0 -80
- package/docs/upstream-repository/skills-contributing.md +0 -15
- package/docs/upstream-repository/test-plugin-install.yml +0 -167
- package/skills/i3-enterprise-sop/references/ad/assets-manifest.json +0 -86
- package/skills/i3-enterprise-sop/references/ad/prompts/01-generate.md +0 -58
- package/skills/i3-enterprise-sop/references/ad/prompts/02-review.md +0 -54
- package/skills/i3-enterprise-sop/references/ad/prompts/03-revise.md +0 -54
- package/skills/i3-enterprise-sop/references/ad/prompts/04-recheck.md +0 -54
- package/skills/i3-enterprise-sop/references/ad/readme.md +0 -70
- package/skills/i3-enterprise-sop/references/assets-manifest.json +0 -230
- package/skills/i3-enterprise-sop/references/brd/assets-manifest.json +0 -83
- package/skills/i3-enterprise-sop/references/brd/prompts/01-generate.md +0 -51
- package/skills/i3-enterprise-sop/references/brd/prompts/02-review.md +0 -47
- package/skills/i3-enterprise-sop/references/brd/prompts/03-revise.md +0 -47
- package/skills/i3-enterprise-sop/references/brd/prompts/04-recheck.md +0 -47
- package/skills/i3-enterprise-sop/references/brd/readme.md +0 -50
- package/skills/i3-enterprise-sop/references/codebuddy-project-guide.md +0 -34
- package/skills/i3-enterprise-sop/references/controlled-handoff.md +0 -41
- package/skills/i3-enterprise-sop/references/controlled_handoff.py +0 -379
- package/skills/i3-enterprise-sop/references/engineering-skeleton/adoption.md +0 -200
- package/skills/i3-enterprise-sop/references/engineering-skeleton/catalog.json +0 -17
- package/skills/i3-enterprise-sop/references/engineering-skeleton/readme.md +0 -52
- package/skills/i3-enterprise-sop/references/handoff-contract.md +0 -196
- package/skills/i3-enterprise-sop/references/lifecycle-contract.md +0 -91
- package/skills/i3-enterprise-sop/references/plan-handoff.md +0 -73
- package/skills/i3-enterprise-sop/references/prd/assets-manifest.json +0 -109
- package/skills/i3-enterprise-sop/references/prd/prompts/01-generate.md +0 -64
- package/skills/i3-enterprise-sop/references/prd/prompts/02-review.md +0 -49
- package/skills/i3-enterprise-sop/references/prd/prompts/03-revise.md +0 -48
- package/skills/i3-enterprise-sop/references/prd/prompts/04-recheck.md +0 -47
- package/skills/i3-enterprise-sop/references/prd/readme.md +0 -137
- package/skills/i3-enterprise-sop/references/prd/template-contracts.md +0 -39
- package/skills/i3-enterprise-sop/references/prd/templates/ad.md +0 -17
- package/skills/i3-enterprise-sop/references/readme.md +0 -167
- package/skills/i3-enterprise-sop/references/recovery-contract.md +0 -65
- package/skills/i3-enterprise-sop/references/review-handoff.md +0 -105
- package/skills/i3-enterprise-sop/references/selection-handoff.md +0 -55
- package/skills/i3-enterprise-sop/references/selection_handoff.py +0 -225
- package/skills/i3-enterprise-sop/references/stages.json +0 -271
- package/skills/i3-enterprise-sop/references/technical-baseline/assets-manifest.json +0 -84
- package/skills/i3-enterprise-sop/references/template-contracts.md +0 -142
- package/skills/i3-enterprise-sop/references/testcase/assets-manifest.json +0 -91
- package/skills/i3-enterprise-sop/references/testcase/prompts/01-generate.md +0 -53
- package/skills/i3-enterprise-sop/references/testcase/prompts/02-review.md +0 -51
- package/skills/i3-enterprise-sop/references/testcase/prompts/03-revise.md +0 -49
- package/skills/i3-enterprise-sop/references/testcase/prompts/04-recheck.md +0 -51
- package/skills/i3-enterprise-sop/references/testcase/readme.md +0 -61
- package/skills/i3-enterprise-sop/references/verification/check_execution.py +0 -185
- package/skills/i3-enterprise-sop/references/verification/check_native_execution.py +0 -282
- package/skills/i3-enterprise-sop/references/verification/check_reads.py +0 -348
- package/skills/i3-enterprise-sop/references/verification/readme.md +0 -149
- package/skills/i3-enterprise-sop/references/verification/review-output.schema.json +0 -155
- package/skills/i3-enterprise-sop/references/verification/review_handoff.py +0 -329
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 公共技术规约资料
|
|
2
2
|
|
|
3
3
|
<!-- i3:zh-guide:start -->
|
|
4
4
|
## 中文使用说明
|
|
@@ -8,125 +8,16 @@
|
|
|
8
8
|
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
9
|
<!-- i3:zh-guide:end -->
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
生成 AD 时,默认完整读取本目录的企业应用具体规约和工程目录规范,作为技术与结构输入;项目已明确采用自己的规约或目录约定时优先沿用其实际版本。来源、版本、适用范围和工程映射直接记在 AD §0.3、§9.6,不要求另写采用说明。
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
## 0. 模板与可选技术规约
|
|
16
|
-
|
|
17
|
-
| 资料 | 用途与采用边界 |
|
|
13
|
+
| 文件 | 用途 |
|
|
18
14
|
| --- | --- |
|
|
19
|
-
| [
|
|
20
|
-
| [
|
|
21
|
-
| [
|
|
22
|
-
|
|
23
|
-
随包提供不等于所有项目默认采用。项目已有适用规范时先复用;选择本规约时记录准确路径、文内版本、适用范围及必要差异。多个版本或来源并存且未明确选择时先确认,不按目录最大版本猜选。
|
|
24
|
-
|
|
25
|
-
项目需要调整时,沿用项目现有规范位置或明确维护项目副本;发行原件与项目规范分别定位。项目自改副本优先,不用发行摘要恢复它,不在升级时覆盖项目规范;不可读或存在冲突时如实报告,不静默切换。
|
|
26
|
-
|
|
27
|
-
最短任务示例:
|
|
28
|
-
|
|
29
|
-
```text
|
|
30
|
-
/i3-sop ad
|
|
31
|
-
为当前选定的PRD生成AD,采用我明确提供的《企业应用公共技术规约 v0.0.4》。先核项目已有规范和适用范围,按本次资源目录定位并完整读取规约及必要目录资料;版本以规约§2.3为准,兼容验证按§2.5安排,保留项目自改内容和未决项,生成后交我审阅,暂不进入Plan或Build。
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
资料由本次实际加载的SOP Skill的references/stages.json中auxiliaryResources定位,再读取本清单baselines条目,不要求使用者填写安装内部路径。当前候选是否可用以实际安装内容为准;项目自改资料不被发行来源替换。原版Skill/命令和标准流程保持。
|
|
35
|
-
|
|
36
|
-
## 1. 先核对来源,再选择采用方式
|
|
37
|
-
|
|
38
|
-
只在用户明确采用企业SOP或明确要求本项技术资料任务时使用。安装、出现PRD字样或发现本文件,不代表项目已启用企业SOP;标准任务继续使用原方法。
|
|
39
|
-
|
|
40
|
-
先实际读取项目说明、明确提供的规范和已有采用记录;目录列表和自动上下文只能作线索。不扫描全部项目、宿主、历史样例或备份来猜规范。
|
|
41
|
-
|
|
42
|
-
资源位置与项目规范来源分开判断:
|
|
43
|
-
|
|
44
|
-
- 对本资源,实际读取本次选定目录的README、清单和所选模板;明确采用的项目自改副本优先,已选根不可读或损坏时报告缺项,不换发行原件或全局新版。
|
|
45
|
-
- 对项目规范,优先复用项目已明确采用且适用的集团/平台/工程规范、CONSTRAINTS、ADR及正式契约。已有代码和锁文件提供实现事实,不自动成为替换规范的决定。
|
|
46
|
-
- 用户本次明确材料与既有采用发生冲突时,同时保留并核对适用范围;本次提供文件不自动授权覆盖原规范、取消约束或切换全项目采用。
|
|
47
|
-
- “规范未提供/未读取”与“项目确认没有规范”分开。不可读、无适用版本或存在冲突时,记录准确缺口及影响;不能从缺文件推断不存在。
|
|
48
|
-
|
|
49
|
-
## 2. 路径一:已有适用规范
|
|
50
|
-
|
|
51
|
-
1. 读已有规范及采用记录,固定可回读内容与本项目适用条款。可使用准确版本加固定提交、不可变快照或实际计算的摘要;未计算就明确说明。只有版本标签和可变链接不足以区分内容时,补固定依据。
|
|
52
|
-
2. 用模板核对覆盖,沿用已有位置、身份和格式。内容已完整时,只在现有采用说明或本次唯一明确目标中记录引用及真实缺口;不复制全文、迁移文件或要求填一份同构大文档。
|
|
53
|
-
3. 公共规则直接引用唯一权威。仅当实际存在项目特定约束时补充有来源的差异,注明维护位置和适用范围;有冲突先列Q,不悄悄覆盖。
|
|
54
|
-
4. 记录本次AD如何引用这些规则的方式即可,不自动生成或修改AD。每份AD仍需自己的三图和完整工程设计。
|
|
55
|
-
|
|
56
|
-
最小采用记录可以使用项目现有表格表达,无需新的registry:
|
|
57
|
-
|
|
58
|
-
| 记录项 | 需要的实际内容 |
|
|
59
|
-
| --- | --- |
|
|
60
|
-
| 来源与固定内容 | 规范身份、权威位置、版本/固定提交或真实摘要、实际读取范围 |
|
|
61
|
-
| 本次适用 | 项目/工程/主题范围、准确条款、实际采用依据;阅读不等于采用或批准 |
|
|
62
|
-
| 落实与差异 | 项目补充或AD引用位置、例外及真实决定;无差异就直接引用 |
|
|
63
|
-
| 项目本地修改 | 当前副本与发行来源分别记录;同名同版本改变后旧证据不自动沿用 |
|
|
64
|
-
| 缺口与交接 | 未读、未知、冲突、需何答复、只影响哪些动作和独立可继续部分 |
|
|
65
|
-
|
|
66
|
-
已有文件或人工修改先读并保留,不用发行摘要恢复项目副本。已有采用说明已足够时,可以只提出只读核对结果;是否写入及唯一目标由本次实际授权决定。
|
|
67
|
-
|
|
68
|
-
## 3. 路径二:缺少规范时起草最小候选
|
|
69
|
-
|
|
70
|
-
先确认已取得的项目事实与已查范围;未知保持Q。按模板涵盖共用架构、技术工程、身份安全、契约通则、共享数据、工程质量、交付恢复、维护例外八个领域。可以直接固定引用,不强制拆出八份文档或重复已有材料。
|
|
71
|
-
|
|
72
|
-
沿用项目既有位置;没有约定时,可建议 `docs/engineering/{项目名称}-技术规约_v0.0.1.md` 作为共用辅助文档。建议路径不是已经存在、已采用或可覆盖的事实。核心业务文档的一能力一目录和主题命名保持。
|
|
73
|
-
|
|
74
|
-
没有事实时,不默认框架、数据库、消息中间件、部署平台、权限、责任人、保留期限、质量数字或命令。项目已明确采用的公共平台约束应引用保留,准确版本和工程细节未取得时列Q,不重新选另一套默认。项目尚未建成时,命令、目录、风格示例和环境可以待定,不编造已运行证据。
|
|
75
|
-
|
|
76
|
-
最小候选不要求全项目技术问题先清零。AD可先起草独立部分,原型按需并行;共同定义未决时,只限制依赖范围。交原Plan前补齐当前有效规格六项、依赖范围的共用定义和必要真实认可;Plan形成、获准逐任务Build及真实工程验收分别核对,不要求起草规范前已有构建通过。
|
|
77
|
-
|
|
78
|
-
## 4. 规约、契约、AD与版本
|
|
79
|
-
|
|
80
|
-
| 内容 | 唯一维护责任与交接 |
|
|
81
|
-
| --- | --- |
|
|
82
|
-
| 公共技术规约 | 维护共用原则或准确权威引用;不替代产品规则、CONSTRAINTS或ADR |
|
|
83
|
-
| 正式接口/事件/数据定义 | 每项一个权威位置,字段与行为分担时明确范围;可先用提供方AD固定章节,不强制新协议或拆文件 |
|
|
84
|
-
| 主题AD | 对应选定PRD完整设计,固定规范版本、条款、提供/消费契约及落实/例外;不包办另一主题PRD |
|
|
85
|
-
| TestCase/实际报告 | 预期直接核PRD,技术判据核AD及契约;候选、真实执行和人工认可分开 |
|
|
86
|
-
| 工程登记与锁 | 记录实际选择、正式采用、应用及验证事实;不另建架构权威或任务tracker |
|
|
87
|
-
|
|
88
|
-
同一PBC多份主题PRD各自独立版本,每份配套逻辑AD及TestCase;文档不要求同号。规范版本、契约版本、代码/制品和环境分别固定。兼容核实际消费者、字段及语义、迁移和运行组合,不能靠版本号或Schema通过下结论。
|
|
89
|
-
|
|
90
|
-
共享数据、状态及文件明确唯一逻辑维护责任与受控写入;前端、后端、Agent及jobs各自状态不能代替正式业务结果。具体角色、事务和数据保留必须有产品/规范依据。
|
|
91
|
-
|
|
92
|
-
变更先固定旧/新内容及来源,定位直接和必要传递的契约、AD、AC、TestCase及真实任务,区分不受影响范围。人可人工修改、明确委托修订、有据不采纳或保持Q;不自动重写全项目、自动升版或承接旧批准。外部契约正式采用与模板实际应用并验证的锁分别留证,本作业不自动创建锁。
|
|
93
|
-
|
|
94
|
-
## 5. 写入、审查与退出
|
|
95
|
-
|
|
96
|
-
写前列明项目根、已读资料、已有规范/采用记录、固定来源、假设/Q、唯一目标和本次权限。先读现稿,保留人工内容和原报告;仅写明确获准目标,未知权限或覆盖风险时先说明。
|
|
97
|
-
|
|
98
|
-
最后编辑后实际回读:新增要求逐条回查来源,规范与权限描述一致,逐表检查表头列数和列义。摘要、版本与内容相符,不要求文档写自身摘要。
|
|
99
|
-
|
|
100
|
-
审查只标注问题、来源、位置、影响与建议,保留人工修改空间。只有真实独立新上下文才称独立审查,无隔离能力时提供新会话任务;自查不冒称独立。修订另行明确,不为清零代答业务或技术决定。
|
|
101
|
-
|
|
102
|
-
完成后报告来源/目标、复用方式、补充与Q、实际验证和未执行事项,交人工审阅并停轮,不自动进入AD、Plan、Build、测试执行、提交或发布。
|
|
103
|
-
|
|
104
|
-
## 6. 可复制任务说明
|
|
105
|
-
|
|
106
|
-
可明确提供本资源目录或项目已采用副本,也可在明确企业任务后按[上层入口](../readme.md)及其索引定位本辅助资源。源码登记不等于宿主自动发现,以下均为明确任务,没有新增slash命令。
|
|
107
|
-
|
|
108
|
-
已有规范:
|
|
109
|
-
|
|
110
|
-
```text
|
|
111
|
-
本次只做公共技术规约采用核对。使用我明确提供的公共技术规约资源,先实际读取该目录README、清单和模板,再读取当前项目说明、已有规范及采用记录。
|
|
112
|
-
优先复用项目已采用规范,固定来源、内容与适用条款;已有资料完整时只记录引用和真实缺口,不复制一份新规范,不覆盖原规范或人工修改。
|
|
113
|
-
写前说明事实、假设、未读取项和唯一获准目标。位置按项目已有约定选择;若存在歧义或覆盖风险,先说明,不新建另一套registry。
|
|
114
|
-
不把阅读当采用、把采用当批准;冲突按影响保留Q,不自行改选型或权限。最后回读候选,新增要求逐条回源,权限描述一致,表格逐行核列数与列义。完成后交我审阅并停轮。
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
新项目或资料不足:
|
|
118
|
-
|
|
119
|
-
```text
|
|
120
|
-
本次只起草项目公共技术规约候选。先读取我明确提供的资源README、清单、模板及当前项目资料,确认已有规范、已查范围和未取得内容;如果找到适用规范,优先采用它。
|
|
121
|
-
确实缺少规范时,按模板只写当前有依据的最小候选,可用固定引用代替重复正文。框架、版本、责任、权限、质量数字、命令和运行结果没有来源就列Q,不填默认答案。
|
|
122
|
-
沿用项目已有位置和命名,只写本次明确的唯一目标,保护人工内容。草拟不冒充可计划或获准Build;每份主题AD仍须三图及完整设计,原型按需。
|
|
123
|
-
最后实际回读,逐条核新增要求来源、权限一致性及表格列数/列义,列出缺口和未执行事项,交我审阅并停轮。原版技能和命令不动,不写AD、Plan、工程或测试结果,不提交发布。
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
## 7. 资源范围与后续接入
|
|
15
|
+
| [企业应用具体规约](baselines/enterprise-application-technical-baseline-v0-0-4.md) v0.0.4 | 本 Skill生成 AD 的默认技术规约;项目明确资料优先 |
|
|
16
|
+
| [工程目录规范](../engineering-skeleton/directory-standard.md) 1.0.0 | AD默认结构输入;约定工程职责和目录,不代表代码已创建 |
|
|
17
|
+
| [通用技术规约模板](templates/technical-baseline.md) v0.0.1 | 没有可用具体规约时,根据项目真实资料起草规约候选 |
|
|
127
18
|
|
|
128
|
-
|
|
19
|
+
具体规约缺失、不可读或不适用时,先提示用户按通用模板生成,说明已有材料、缺口和建议目标。取得技术文档写入委托后起草并交审,用户确认后继续 AD;不用空模板充当技术规约,不编选型、版本、权限或运行结果,不要求用户另启一个入口。
|
|
129
20
|
|
|
130
|
-
|
|
21
|
+
项目自改资料先读取并保留;已选来源失效或冲突时说明影响,不静默回退发行副本。默认作为 AD输入不等于已获业务批准、工程可运行或兼容验证通过,也不授权更改项目环境和代码。
|
|
131
22
|
|
|
132
|
-
|
|
23
|
+
本轮不重新核实原规约的官方版本、安装环境和兼容运行;原未验证条件继续保留,具体技术条款和版本矩阵不因目录整理改变。资源模板、具体规约和业务文档版本分别维护。
|
|
@@ -8,17 +8,18 @@
|
|
|
8
8
|
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
9
|
<!-- i3:zh-guide:end -->
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
模板版本:v0.1.6。模板版本与业务文档版本分别维护。
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## 使用说明(不复制为业务正文)
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
- **输入:**准确选定的 PRD,或外部 AD及需求依据;默认带入本 Skill 自带的企业应用具体规约与目录规范,项目已有明确规约或目录约定时优先沿用,并读取必要契约与工程事实。
|
|
16
|
+
- **输出:**对应一个准确 PRD 版本的主题 AD;默认保存到业务项目的本PBC目录,路径为`spec/{PBC名称}/{PBC名称}-{主题名称}-AD_v{业务版本}.md`,不强制与PRD同号。已有明确采用位置或外部原件保留实际路径,不自动迁移。
|
|
17
|
+
- **阶段职责:**整体技术架构图、功能架构图、ER 图为必需视图;保留字段、接口、数据责任、权限、状态、事务、并发、恢复及完整工程定义。原型按需,可与 AD 并行,不作为统一前置。默认具体规约与目录规范是生成输入,项目明确资料优先;缺少可用具体规约时先提示按通用模板生成并交审,再继续 AD。目录约定与真实源码分别表达,采用信息直接记本 AD。
|
|
18
|
+
- **写作:**主会话按本 Skill 显式使用原 Spec;来源、假设、真实答复与 Q 分开。新建、外部稿整理与授权修订均保护业务原件、人工编辑和历史,不预填批准或运行结果。
|
|
19
|
+
- **交付:**按下文完整填写适用内容,不以标题或数量代替语义覆盖;新增规范性要求逐条回查来源、权限与状态跨处一致、表格逐行核列义。生成或修订稿保存后检查落盘完整性,分段写入或报错时核对相关内容,保留内容自查;检查完成后按本Skill自动登记本次文档路径,再交人工审阅并停轮。登记不表示批准,只读审查只标注问题,不改稿或登记。
|
|
20
|
+
- **工程衔接:**T1形成企业文档并交审;T2显式使用原 Spec,结合选定依据落实六项、形成工程 SPEC并交审;T3读取选定工程 SPEC调用原规划。每阶段保留人工审阅停点,不自动推进。工程事实缺失如实说明,不编造命令、代码或技术选型。用户另行明确选择原生等效规格方式时,沿原方法处理。
|
|
16
21
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
AD §9 明确保留原 SPEC 的完整命令、项目目录、代码风格和工程边界;测试策略与 TestCase §3.1 固定衔接。四类模板是外部规格表示,不另造第五核心规格、不强制复制 SPEC,也不改变继承 Skill 的触发、输出、工具、验证或认可要求。所填状态和字段不构成原方法所需的人类决定。
|
|
20
|
-
|
|
21
|
-
**整体技术架构图、功能架构图、ER 图均为必需视图。** 下列图是填写骨架,占位实体、关系、基数和箭头不代表已经确认的架构。实例必须按真实输入替换,正文表格补全工程定义;图形齐全不等于可以实施。缺口只阻断依赖它的范围,不能为补齐图而虚构组件、表或业务规则。
|
|
22
|
+
未知项写明 Q及具体影响,不适用项说明依据;缺少工程条件只限制依赖它的范围。
|
|
22
23
|
|
|
23
24
|
---
|
|
24
25
|
|
|
@@ -28,9 +29,11 @@ AD §9 明确保留原 SPEC 的完整命令、项目目录、代码风格和工
|
|
|
28
29
|
|
|
29
30
|
| 项目 | 本次实际值 |
|
|
30
31
|
| --- | --- |
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
32
|
+
| 所属 EBC | `{ebcId;ebcName;已确认或候选边界}` |
|
|
33
|
+
| 所属 PBC | `{pbcId;pbcName;已确认或候选边界}` |
|
|
34
|
+
| 产品需求主题 | `{稳定prdId;主题名称;改名不换身份}` |
|
|
35
|
+
| 文档身份/版本/位置 | `{documentId;类型AD;实际业务版本;可回读路径;摘要可选}` |
|
|
36
|
+
| 直接产品依据 | `{唯一选定PRD的documentId、文内版本、实际路径及条款;EBC/PBC/主题与本稿一致;回读正文,不自动取最新}` |
|
|
34
37
|
| 原型/组件/公共基线 | `{适用版本与认可范围;没有或不适用则说明影响}` |
|
|
35
38
|
| 当前设计范围 | `{全部有效目标、变化/保留/替代及仅比较材料}` |
|
|
36
39
|
| 现有工程基准 | `{代码、数据、接口、实际运行/部署状态;未实现/未读取分别说明}` |
|
|
@@ -38,12 +41,14 @@ AD §9 明确保留原 SPEC 的完整命令、项目目录、代码风格和工
|
|
|
38
41
|
|
|
39
42
|
### 0.1 固定输入与权威定义
|
|
40
43
|
|
|
41
|
-
|
|
|
44
|
+
| 引用 ID/输入或附件类型 | 来源身份/实际路径或URL/文内版本或固定提交/条款(摘要可选) | 定义权威范围 | 本 AD 使用位置 | 已读/可用/认可与缺口 |
|
|
42
45
|
| --- | --- | --- | --- | --- |
|
|
43
|
-
| `{PRD
|
|
46
|
+
| `{IN别名;直接PRD/原型/已有代码/外部规范/Schema等}` | `{documentId或资料标识及适用ebcId/pbcId/prdId;能回读的准确位置、版本和条款}` | `{产品/交互/API/数据/公共规则等}` | `{章节/条目}` | `{实际采用、仅参考或缺项;文档存在不代表真实服务可用}` |
|
|
44
47
|
|
|
45
48
|
精确 OpenAPI、Schema、DDL、数据字典可以在受控附件维护,正文声明权威范围并固定引用,不能各自保存不同答案。没有附件时在正文完整定义;不能虚构附件已存在。
|
|
46
49
|
|
|
50
|
+
直接PRD与本稿的EBC/PBC编号名称和prdId须一致,名称变化不换编号;本文documentId与版本独立维护。跨PBC契约或关联设计明确提供方/消费方的来源身份、准确路径/版本、采用范围与本AD落实位置,不要求参考对象属于本主题,也不允许其替代直接产品依据。原型、规约、目录规范、实际模板/骨架和契约在现有输入/采用表固定引用,不依赖handoff.json的扩展字段,不另建平行清单;必要来源缺失或冲突时说明受限范围。
|
|
51
|
+
|
|
47
52
|
### 0.2 决定、未决与变化
|
|
48
53
|
|
|
49
54
|
| ID | 事项/方案 | 已定规则/项目决定/待核实 | 来源、备选及理由 | 影响范围 | 实际认可或关闭依据 |
|
|
@@ -54,17 +59,17 @@ AD §9 明确保留原 SPEC 的完整命令、项目目录、代码风格和工
|
|
|
54
59
|
|
|
55
60
|
### 0.3 公共技术规约、契约与骨架的本次采用
|
|
56
61
|
|
|
57
|
-
AD
|
|
62
|
+
AD准备默认读取本 Skill自带的企业应用具体规约与目录规范;项目已有明确规约、目录约定时优先沿用,不复制平行规范。再读取 CONSTRAINTS、ADR、正式契约和实际工程事实,在下表记录默认或项目选定来源、准确版本、适用条款及例外,不另要求采用说明文件。没有可读、适用的具体规约时,先提示根据通用技术规约模板生成,明确技术文档目标与写入委托后起草交审;用户确认后继续 AD。通用模板本身不是实际约束,不能填造选型或静默多写文件。
|
|
58
63
|
|
|
59
|
-
| 采用ID/类型 |
|
|
64
|
+
| 采用ID/类型 | 来源身份/准确路径或URL/文内版本或固定提交/条款 | 本次角色与适用范围 | 本AD落实位置/例外 | 实际读取与缺口/决定依据 |
|
|
60
65
|
| --- | --- | --- | --- | --- |
|
|
61
|
-
| `{BASE:公共规范}` | `{
|
|
62
|
-
| `{CONTRACT/DATA:共享定义}` | `{唯一Schema、契约正文或提供方AD
|
|
63
|
-
| `{SKELETON:工程骨架}` | `{
|
|
66
|
+
| `{BASE:公共规范}` | `{项目明确规约,或默认企业应用规约的标识、实际路径、文内版本与条款;固定提交或摘要按需}` | `{本主题适用部分,不以规范代产品规则}` | `{具体章节或明确偏差}` | `{已读内容;未取得或冲突保留Q}` |
|
|
67
|
+
| `{CONTRACT/DATA:共享定义}` | `{唯一Schema、契约正文或提供方AD的身份、准确路径、版本与固定章节;标明来源EBC/PBC/主题}` | `{提供/消费/只读;精确行为范围}` | `{§5、§6、§8及精确条目}` | `{选用依据不等于服务就绪}` |
|
|
68
|
+
| `{SKELETON:工程骨架}` | `{本Skill目录规范或项目既有规范的路径、版本及条款;实际模板/源码有则另记来源标识、仓库/路径和固定版本/提交}` | `{工程类型、适用目录和责任}` | `{§9.6;与规范兼容或例外}` | `{已取得/拟采用/未应用/未验证分别记录}` |
|
|
64
69
|
|
|
65
|
-
|
|
70
|
+
本表只组织引用,详细权威仍在来源文件,字段定义不在多表重复维护。实际读取本模板、选定具体技术规约、目录规范及必要业务原件,由本 Skill直接定位;项目明确采用的副本优先。已选来源失效或冲突时报告实际差异,不按最大版本猜选,也不要求另行准备索引、清单或提示词。
|
|
66
71
|
|
|
67
|
-
基本交接按路径、正文及文内版本核对,不强制SHA256
|
|
72
|
+
基本交接按路径、正文及文内版本核对,不强制SHA256;同路径人工修改需要回读并判断影响,旧认可不自动转移。正式发布规范或契约已有的不可变版本/摘要要求按其原用途保留。交稿路径登记由本Skill处理,本模板不自行选择资料或写入项目配置。
|
|
68
73
|
|
|
69
74
|
## 1. 需求覆盖与工程驱动
|
|
70
75
|
|
|
@@ -104,7 +109,7 @@ flowchart LR
|
|
|
104
109
|
| --- | --- | --- | --- | --- | --- |
|
|
105
110
|
| `{本主题及必要关联范围}` | `{独立主题、独立版本;未形成如实说明}` | `{引用§0.3与唯一权威,不重写正文}` | `{未产生不填已部署或已测试}` | `{设计相容/未知/冲突;实际证据位置}` | `{并存窗口、发布顺序、恢复限制及责任;未知列Q}` |
|
|
106
111
|
|
|
107
|
-
分别核调用类型、序列化与严格消费者,行为/权限/默认值/状态,数据迁移及并存写入,运行时和装配条件。新增字段、枚举或默认值也可能不兼容;文档同号、SemVer主版本相同或Schema
|
|
112
|
+
分别核调用类型、序列化与严格消费者,行为/权限/默认值/状态,数据迁移及并存写入,运行时和装配条件。新增字段、枚举或默认值也可能不兼容;文档同号、SemVer主版本相同或Schema校验通过都不能替代实际语义与消费者核对。设计核对、T2工程SPEC交审、T3规划、获准Build和真实集成结果分别表达,不要求所有AD机械升级到最新规范。
|
|
108
113
|
|
|
109
114
|
## 3. 功能架构与实现链路
|
|
110
115
|
|
|
@@ -224,6 +229,8 @@ erDiagram
|
|
|
224
229
|
|
|
225
230
|
## 8. 状态、服务规则与恢复
|
|
226
231
|
|
|
232
|
+
**EARS 使用:**适用的技术行为写清条件、触发事件、执行组件和可观察响应,以及拒绝、失败、结果未知时的处理和副作用。依据 PRD/AC细化并关联本 AD的接口、数据或状态条款;架构图、接口和数据定义仍按相应章节完整说明。
|
|
233
|
+
|
|
227
234
|
| 规则/状态 ID | 前置条件与触发者 | 确定分支/后置状态 | 权限、责任与事务 | 拒绝/异常/重复/未知 | 恢复与可观察证据 |
|
|
228
235
|
| --- | --- | --- | --- | --- | --- |
|
|
229
236
|
| `{PRD引用与技术细化}` | `{条件}` | `{允许/禁止转换}` | `{契约/数据引用}` | `{错误码及副作用边界}` | `{查询、补偿、审计、人工介入}` |
|
|
@@ -291,21 +298,21 @@ erDiagram
|
|
|
291
298
|
|
|
292
299
|
| 工程/仓库/模块范围 | 实际骨架或拟采用模板及固定来源 | 初始化/增量内容 | 构建/启动/配置/依赖 | 测试与恢复前提 | 当前事实 |
|
|
293
300
|
| --- | --- | --- | --- | --- | --- |
|
|
294
|
-
| `{一能力不强制一工程}` | `{
|
|
301
|
+
| `{一能力不强制一工程}` | `{引用第0.3节采用ID;实际取得的模板/源码标识、仓库/路径、版本或固定提交及本地差异;未取得明确待提供}` | `{只写有依据的工程任务}` | `{精确规则或缺口}` | `{必要条件}` | `{已存在/拟建/待核实}` |
|
|
295
302
|
|
|
296
303
|
固定引用 §9.1–9.4 的命令、目录、代码风格和工程边界,不手工维护第二套不同答案。补充依赖与锁文件、构建制品、环境和密钥引用、部署顺序、特性开关、迁移兼容、回滚和运行交接;测试框架、测试目录、层级及适用覆盖要求由 TestCase §3.1 承接。不给真实凭据,不把配置计划当实际就绪,不代替生产授权;CONSTRAINTS、ADR 等辅助产物仍按原方法和项目约定维护。
|
|
297
304
|
|
|
298
|
-
|
|
305
|
+
目录规范是 AD 的结构输入,真实模板/源码不是 AD起草的统一前置。将规范映射到项目的工程与模块位置,已有、拟建、未取得和未验证分别记录;如另用实际代码模板,再注明真实来源、版本和本地差异,目录图不代表工程已经应用。优先保留现有仓库与人工代码,采用信息直接记本 AD,不另建说明或复制平行骨架。适用的pbc-composite/agent-standalone与frontend/backend/agents/jobs按实际选择说明,contracts/shared/tests/delivery的责任不能遗漏;不需要的工程说明依据,不默认一PBC一仓库或一服务。
|
|
299
306
|
|
|
300
|
-
AD
|
|
307
|
+
AD定义采用、工程落位与例外,T2承接到工程SPEC,T3由原Plan安排初始化或增量任务、文件责任、验证和恢复;获准Build才实际应用模板或改动工程。现有工程根记录真实路径,新工程未创建时只写拟建位置和缺口。锁文件按已采用工具和项目规则处理,不因目录规范另建templates.lock、contracts.lock或生成记录库;已有文件保留其实际用途。本次AD写作不创建锁、工程、运行报告或第二套任务tracker。更新须保护人工修改,实际应用失败不能覆盖旧有效基线,应用和验证结果由对应工程任务记录。
|
|
301
308
|
|
|
302
|
-
## 10. TestCase
|
|
309
|
+
## 10. TestCase、T2工程SPEC与T3实施计划交接
|
|
303
310
|
|
|
304
311
|
| PRD需求/AC或工程条款 | AD精确落点 | 可观察成功/失败/副作用 | TestCase用例或待形成 | 实施前提与依赖 |
|
|
305
312
|
| --- | --- | --- | --- | --- |
|
|
306
313
|
| `{固定条目}` | `{图/字段/契约/事务/规则}` | `{可断言结果}` | `{固定引用或缺口}` | `{环境/契约/数据/工具/认可}` |
|
|
307
314
|
|
|
308
|
-
|
|
315
|
+
本AD作为T2工程SPEC的设计依据;T2结合选定PRD及采用资料落实六项并交审,T3再依据选定工程SPEC调用原Plan。Plan形成后取得范围/执行模式认可,执行前核实任务条件;不能把获批Plan写成形成Plan的前置要求。共享底座或独立技术准备可形成有依据的任务,不借初始化提前生成未定业务字段/权限/接口。
|
|
309
316
|
|
|
310
317
|
### 10.1 公共变更、例外与影响范围
|
|
311
318
|
|
|
@@ -315,7 +322,7 @@ AD只选择并定义落实与例外;原Plan据此安排初始化或增量任
|
|
|
315
322
|
|
|
316
323
|
先确定变化及来源,再定位直接和必要传递消费者,核行为、权限、数据、迁移和运行组合,提出最小处理及恢复。公共定义改变需在其权威位置处理;本主题AD只记录建议和影响,不自行修改公共规范、契约或另一主题。保留原有有效需求及已交付行为的回归,范围降级或移出须有来源和真实决定;不机械重写无关AD、强制升版或重新询问未受影响的已有授权。
|
|
317
324
|
|
|
318
|
-
独立审查只读标注,使用者可人工处理、明确委托修订、有据不采纳或保留Q;按改动影响复查,零问题不等于业务批准。若JSON
|
|
325
|
+
独立审查只读标注,使用者可人工处理、明确委托修订、有据不采纳或保留Q;按改动影响复查,零问题不等于业务批准。若JSON清单尚未接入,手动传递准确路径仍可作为T2输入。T2工程SPEC保留实际PRD、AD、规范、契约、骨架来源及关键设计;T3原Plan将其落实到任务、结构与行为验收及验证步骤。Build按获准任务回读所需正文,输入变化先核与计划的影响,不靠可变清单链接或旧会话摘要代替正文。
|
|
319
326
|
|
|
320
327
|
## 11. 完成核对、问题与版本记录
|
|
321
328
|
|
|
@@ -8,11 +8,18 @@
|
|
|
8
8
|
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
9
|
<!-- i3:zh-guide:end -->
|
|
10
10
|
|
|
11
|
-
模板版本:v0.
|
|
11
|
+
模板版本:v0.1.6。模板版本与业务文档版本分别维护。
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## 使用说明(不复制为业务正文)
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
- **输入:**自然语言业务诉求或外部 BRD;已有背景、目标、角色、场景、约束及真实答复按实际采用读取。
|
|
16
|
+
- **输出:**一个 EBC 的逻辑 BRD及明确的 PBC 建议;默认直接保存到业务项目的`spec/`根目录,路径为`spec/{EBC名称}-BRD_v{业务版本}.md`。已有明确采用位置或外部原件保留实际路径,不自动迁移。
|
|
17
|
+
- **阶段职责:**根据业务目标、输入输出、对象与规则责任、依赖和独立演进识别 PBC,不把菜单、部门、数据表或服务自动当作 PBC。
|
|
18
|
+
- **写作:**主会话按本 Skill 显式使用原 Spec;来源、假设、真实答复与 Q 分开。新建、外部稿整理与授权修订均保护业务原件、人工编辑和历史,不预填批准或运行结果。
|
|
19
|
+
- **交付:**按下文完整填写适用内容,不以标题或数量代替语义覆盖;新增规范性要求逐条回查来源、权限与状态跨处一致、表格逐行核列义。生成或修订稿保存后检查落盘完整性,分段写入或报错时核对相关内容,保留内容自查;检查完成后按本Skill自动登记本次文档路径,再交人工审阅并停轮。登记不表示批准,只读审查只标注问题,不改稿或登记。
|
|
20
|
+
- **工程衔接:**T1形成企业文档并交审;T2显式使用原 Spec,结合选定依据落实六项、形成工程 SPEC并交审;T3读取选定工程 SPEC调用原规划。每阶段保留人工审阅停点,不自动推进。工程事实缺失如实说明,不编造命令、代码或技术选型。用户另行明确选择原生等效规格方式时,沿原方法处理。
|
|
21
|
+
|
|
22
|
+
未知项写明 Q及具体影响,不适用项说明依据;缺少工程条件只限制依赖它的范围。
|
|
16
23
|
|
|
17
24
|
---
|
|
18
25
|
|
|
@@ -20,14 +27,16 @@ BRD 承接原 SPEC 的目标、用户与业务成功依据;工程命令、目
|
|
|
20
27
|
|
|
21
28
|
| 文档属性 | 实际内容 |
|
|
22
29
|
| --- | --- |
|
|
23
|
-
| EBC 身份与名称 | `{
|
|
24
|
-
| 文档身份、版本、状态 | `{documentId;v0.0.1
|
|
30
|
+
| EBC 身份与名称 | `{ebcId;ebcName;责任边界及已确认或候选状态}` |
|
|
31
|
+
| 文档身份、版本、状态 | `{documentId;类型BRD;v0.0.1或实际业务版本;实际状态}` |
|
|
25
32
|
| 文件位置与固定内容 | `{完整路径或仓库引用;固定副本/提交及摘要;未绑定则注明}` |
|
|
26
33
|
| 发起人、维护者、编写者 | `{真实主体;业务维护与代理编写分开}` |
|
|
27
34
|
| 创建/更新日期 | `{真实日期}` |
|
|
28
35
|
| 采用模板及公共基线 | `{固定模板版本与内容;实际取得的集团/项目基线;缺项及影响}` |
|
|
29
36
|
| 比较基准与确认范围 | `{前一有效版本或无前稿;实际认可来源;未取得确认直写未取得}` |
|
|
30
37
|
|
|
38
|
+
沿已有来源、采用和交接位置固定引用:记录引用ID/类型、来源名称与身份、实际路径或URL、正文版本或固定提交及具体条款、本次采用范围与落实位置、实际状态和缺口,摘要按需记录。来源没有稳定编号时用文内引用ID,不虚构能力或文档编号;直接依据与关联参考分别标明用途。本文身份属于一个EBC,多个PBC的编号、名称和边界在第8章分配表记录。名称变化不换编号,引用也不因JSON精简而省略;不用额外的平行清单。
|
|
39
|
+
|
|
31
40
|
## 0. 版本历史与采用范围
|
|
32
41
|
|
|
33
42
|
| 文档版本/日期 | 实际主体 | 修改内容及来源 | 与前版关系 | 受影响 PBC/主题和处理 |
|
|
@@ -38,7 +47,7 @@ BRD 承接原 SPEC 的目标、用户与业务成功依据;工程命令、目
|
|
|
38
47
|
|
|
39
48
|
### 1.1 原始诉求与现状
|
|
40
49
|
|
|
41
|
-
`{保留发起人原始诉求或可回读
|
|
50
|
+
`{保留发起人原始诉求或可回读SRC引用;标明引用ID/类型、来源身份、准确位置、版本或固定内容、引用条款和用途,未取得处写缺口;描述当前业务方式、涉及对象与已核实事实。原件只读,整理不覆盖原始材料。}`
|
|
42
51
|
|
|
43
52
|
### 1.2 问题与影响
|
|
44
53
|
|
|
@@ -78,6 +87,8 @@ BRD 承接原 SPEC 的目标、用户与业务成功依据;工程命令、目
|
|
|
78
87
|
| --- | --- | --- | --- | --- | --- | --- |
|
|
79
88
|
| `{稳定BR}` | `{具体诉求}` | `{来源等级或未给定}` | `{本次/后续/候选/排除}` | `{问题/目标}` | `{SRC及真实主体}` | `{可观察结果}` |
|
|
80
89
|
|
|
90
|
+
**EARS 使用:**对适用的业务规则,写清条件、事件及业务结果;涉及系统行为时明确由哪个系统响应。背景、价值和目标仍按本模板表达;未确定的规则列待确认问题,不擅自增加技术实现。
|
|
91
|
+
|
|
81
92
|
BR 拆分、撤回或替代保留关联,不用旧 ID 指代另一诉求。优先级与交付安排分开,不把全部高优需求自动当作已批准范围。
|
|
82
93
|
|
|
83
94
|
### 4.3 智能能力业务边界(适用时)
|
|
@@ -106,9 +117,9 @@ BR 拆分、撤回或替代保留关联,不用旧 ID 指代另一诉求。优
|
|
|
106
117
|
|
|
107
118
|
## 8. 范围与 PBC 分配
|
|
108
119
|
|
|
109
|
-
| BR/明确约束 | 本次/后续/排除/待定 | 承接 PBC | 产品需求主题或待细化 | 其他责任方/去向 | 依据及缺口 |
|
|
120
|
+
| BR/明确约束 | 本次/后续/排除/待定 | 承接 PBC 编号/名称 | 产品需求主题或待细化 | 其他责任方/去向 | 依据及缺口 |
|
|
110
121
|
| --- | --- | --- | --- | --- | --- |
|
|
111
|
-
| `{稳定引用}` | `{明确分类}` | `{
|
|
122
|
+
| `{稳定引用}` | `{明确分类}` | `{pbcId;pbcName;候选边界标候选}` | `{已有prdId/主题名称或待定,不预造FR/AC}` | `{实际对象或未分配}` | `{SRC/决定/Q}` |
|
|
112
123
|
|
|
113
124
|
每条业务诉求和范围外限制都有去向;一个 BR 可以分配给多个 PBC,但共用业务事实应明确权威维护方,不产生相互冲突的副本。“本次不做”不自动变成“以后必须做”。
|
|
114
125
|
|
|
@@ -156,9 +167,9 @@ BR 拆分、撤回或替代保留关联,不用旧 ID 指代另一诉求。优
|
|
|
156
167
|
|
|
157
168
|
### 13.3 PRD 交接摘要
|
|
158
169
|
|
|
159
|
-
`{本次交接的BRD
|
|
170
|
+
`{本次交接的ebcId/ebcName、BRD documentId/文内版本/实际路径与固定内容、承接pbcId/pbcName及已有prdId/主题、BR清单、排除和后续项、Q及影响、适用外部基线的准确引用。已有PRD记录其真实文档身份、路径、版本与承接范围;未形成时写未形成,不预填文件或编号。PRD形成后由PRD维护具体功能和AC,不在此预填尚未产生的条目或通过结论。}`
|
|
160
171
|
|
|
161
|
-
|
|
172
|
+
本摘要供后续企业文档及 T2工程 SPEC读取必要业务背景;T3依据选定工程 SPEC调用原规划。原技能的审批与输出合同、质量约束、ADR和实际验证要求继续保留,模板状态或填写参与者不产生授权。
|
|
162
173
|
|
|
163
174
|
## 完成核对
|
|
164
175
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# PRD
|
|
1
|
+
# PRD 模板
|
|
2
2
|
|
|
3
3
|
<!-- i3:zh-guide:start -->
|
|
4
4
|
## 中文使用说明
|
|
@@ -8,13 +8,26 @@
|
|
|
8
8
|
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
9
|
<!-- i3:zh-guide:end -->
|
|
10
10
|
|
|
11
|
-
模板版本:v0.
|
|
11
|
+
模板版本:v0.1.5。模板版本与业务文档版本分别维护。
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## 使用说明(不复制为业务正文)
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
- **输入:**BRD与本次 PBC/主题,或外部 PRD及其业务依据;已确认答复、适用共享规则和必要比较材料。
|
|
16
|
+
- **输出:**一个 PBC 下的一个独立主题 PRD;默认保存到业务项目的本PBC目录,路径为`spec/{PBC名称}/{PBC名称}-{主题名称}-PRD_v{业务版本}.md`。已有明确采用位置或外部原件保留实际路径,不自动迁移。
|
|
17
|
+
- **阶段职责:**一个 PBC 可有多个主题 PRD,各有稳定 prdId 和独立版本。Feature/Story、FT/US/FR/AC、九项行为语义与 S01—S14、G01—G08 全部保留,不要求另建 Stories 或 MVP 阶段。字段/API/数据库等工程实现由配套 [AD模板](ad.md) 承接。
|
|
18
|
+
- **写作:**主会话按本 Skill 显式使用原 Spec;来源、假设、真实答复与 Q 分开。新建、外部稿整理与授权修订均保护业务原件、人工编辑和历史,不预填批准或运行结果。
|
|
19
|
+
- **交付:**按下文完整填写适用内容,不以标题或数量代替语义覆盖;新增规范性要求逐条回查来源、权限与状态跨处一致、表格逐行核列义。生成或修订稿保存后检查落盘完整性,分段写入或报错时核对相关内容,保留内容自查;检查完成后按本Skill自动登记本次文档路径,再交人工审阅并停轮。登记不表示批准,只读审查只标注问题,不改稿或登记。
|
|
20
|
+
- **工程衔接:**T1形成企业文档并交审;T2显式使用原 Spec,结合选定依据落实六项、形成工程 SPEC并交审;T3读取选定工程 SPEC调用原规划。每阶段保留人工审阅停点,不自动推进。工程事实缺失如实说明,不编造命令、代码或技术选型。用户另行明确选择原生等效规格方式时,沿原方法处理。
|
|
16
21
|
|
|
17
|
-
|
|
22
|
+
未知项写明 Q及具体影响,不适用项说明依据;缺少工程条件只限制依赖它的范围。
|
|
23
|
+
|
|
24
|
+
### 产品语义核对
|
|
25
|
+
|
|
26
|
+
- 权限在角色表、规则、正常/拒绝流程、状态、页面、协作、AC和Q中使用同一条件;核多角色组合、对象归属、状态例外、只读/写入及“有权决定”与“代记结果”的差别。来源未授予的动作不得默认开放。
|
|
27
|
+
- 字段生成、存储、展示、可编辑、必填和校验分别定义;系统生成不自动意味着页面必显或用户必填。校验拒绝、权限拒绝、技术失败和提交结果未知分别表达;成功、重复、取消、历史及跨主题副作用有真实依据。
|
|
28
|
+
- 展开完整当前有效目标,共用要求落实到适用Story/AC或给出不适用理由;旧行为只有本次选定条目才生效,比较资料不自动成为需求。保留、替代、停止适用和未实现分开,范围缩减保留理由、影响及真实决定。
|
|
29
|
+
- 每条AC的前置、动作、可观察结果和来源可定位;复合AC拆可追踪子项。已知依赖列双方准确对象/版本、受影响Story/AC、冻结或决定时点、联调组织、环境/数据/权限/服务前提和实际就绪状态,不能将未知写成已就绪。
|
|
30
|
+
- 最终新增规范性要求回查原意、条件、例外和要求强度;推导/建议不变成已确认。来源矛盾保留双方,问题、建议和未处理事项不为清零而关闭;没有业务决定的规则不能交AD或编码自行选择。
|
|
18
31
|
|
|
19
32
|
---
|
|
20
33
|
|
|
@@ -24,9 +37,10 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件,并提供业务边
|
|
|
24
37
|
|
|
25
38
|
| 项目 | 本次实际值 |
|
|
26
39
|
| --- | --- |
|
|
27
|
-
| 所属 EBC
|
|
40
|
+
| 所属 EBC | `{ebcId;ebcName;已确认或候选边界}` |
|
|
41
|
+
| 所属 PBC | `{pbcId;pbcName;已确认或候选边界}` |
|
|
28
42
|
| 产品需求身份 | `{稳定prdId;主题名称;改名不换身份}` |
|
|
29
|
-
| 文档身份/版本/位置 | `{documentId
|
|
43
|
+
| 文档身份/版本/位置 | `{documentId;类型PRD;实际业务版本;完整路径/固定副本及摘要}` |
|
|
30
44
|
| 状态和责任 | `{草稿/待评审/实际认可范围;维护、编写与确认责任}` |
|
|
31
45
|
| 采用模板与业务输入 | `{固定模板、BRD及实际业务答复;按下表登记}` |
|
|
32
46
|
| 比较基准 | `{前一有效PRD、相关主题、适用原型及实际代码/数据/部署;未实现写未实现}` |
|
|
@@ -34,9 +48,11 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件,并提供业务边
|
|
|
34
48
|
|
|
35
49
|
### 0.1 固定输入
|
|
36
50
|
|
|
37
|
-
|
|
|
51
|
+
| 引用 ID/类型 | 来源身份/实际路径或URL/具体条目 | 文内版本/固定提交与可回读内容(摘要可选) | 来源性质 | 本次用途/采用范围/落实位置 | 实际认可与缺口 |
|
|
38
52
|
| --- | --- | --- | --- | --- | --- |
|
|
39
|
-
| `{IN
|
|
53
|
+
| `{IN别名;直接BRD/SRC/业务答复/旧PRD/共用规则/相关主题}` | `{来源名称/documentId(如有)及适用ebcId/pbcId/prdId;准确位置和条款}` | `{来源正文版本或固定提交/副本;不只写最新版}` | `{明示/推导/确认/冲突/演练}` | `{目标/上下文/仅比较及本文对应位置}` | `{实际情况}` |
|
|
54
|
+
|
|
55
|
+
直接BRD须能回读其documentId、文内版本、实际路径及承接条款,所属EBC与本主题一致;PBC编号和名称沿用其分配或真实业务决定。跨PBC参考显式标明来源身份和用途,不替代本主题直接依据。各文档独立版本,名称变化不换编号;引用在现有表内组织,不另建平行清单。
|
|
40
56
|
|
|
41
57
|
### 0.2 变更与认可
|
|
42
58
|
|
|
@@ -64,7 +80,7 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件,并提供业务边
|
|
|
64
80
|
|
|
65
81
|
| BR/场景/约束 | 本主题承接内容 | 本版/后续/排除/待定 | 功能或共用要求 | 其他主题/PBC 去向 | 依据与缺口 |
|
|
66
82
|
| --- | --- | --- | --- | --- | --- |
|
|
67
|
-
| `{原始引用}` | `{具体边界}` | `{真实分类}` | `{FR/RULE等稳定ID}` | `{
|
|
83
|
+
| `{原始引用}` | `{具体边界}` | `{真实分类}` | `{FR/RULE等稳定ID}` | `{pbcId/prdId/未分配;跨EBC时标明ebcId}` | `{来源/决定/Q}` |
|
|
68
84
|
|
|
69
85
|
说明本 PBC 维护哪些业务事实,本主题负责哪些部分,与同 PBC 其他 PRD 的交接是什么。一个主题可包含多个功能,一个功能也可在本主题的多个版本中演进;不按文件或页面数量推导仓库、服务或能力拆分。
|
|
70
86
|
|
|
@@ -144,6 +160,15 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件,并提供业务边
|
|
|
144
160
|
|
|
145
161
|
对每项新增/修改 Story 或可独立验收的功能展开以下卡片;保留行为可以固定引用完整有效卡片,不要求复制第二份正文。一个 Feature 可有多条 Story,一个功能包含多个独立行为时分别展开,不以一张概括功能卡替代全部行为。简单功能可合并成表,但九项语义和 AC 必须可定位;无页面或无协作的项目写不适用及依据。未知产品行为登记问题,不用“待 AD 确认”替代。
|
|
146
162
|
|
|
163
|
+
**EARS 句式指引(按适用行为选用):**功能要求可参考 [EARS](https://alistairmavin.com/ears/),用简短句式写明条件与系统响应:
|
|
164
|
+
|
|
165
|
+
- 常态:`{系统}应{可观察响应}`。
|
|
166
|
+
- 事件:`当{事件}发生时,{系统}应{可观察响应}`。
|
|
167
|
+
- 状态:`在{状态}期间,{系统}应{持续约束或响应}`。
|
|
168
|
+
- 异常:`若{异常条件}成立,则{系统}应{处理结果及副作用边界}`。
|
|
169
|
+
|
|
170
|
+
状态与事件可组合。保留来源中的要求强度、条件及例外,不补造权限、状态、参数或阈值;未知项登记 Q。句式指引不代替下列九项语义、逐条 AC及来源追溯,也不要求改写背景、目标或既有编号。
|
|
171
|
+
|
|
147
172
|
### {Story/功能 ID} · {名称}(所属 Feature/分组及原标识映射见0.3)
|
|
148
173
|
|
|
149
174
|
1. **用户与目标**:`{角色及价值,引用第3章}`。
|
|
@@ -164,15 +189,15 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件,并提供业务边
|
|
|
164
189
|
|
|
165
190
|
## 7. 页面、渠道、协作与智能能力
|
|
166
191
|
|
|
167
|
-
| 页面/入口 ID | 目的与角色 | 主要区域/业务信息 | 动作及来源 | 正常/空态/失败/无权限等要求 |
|
|
192
|
+
| 页面/入口 ID | 目的与角色 | 主要区域/业务信息 | 动作及来源 | 正常/空态/失败/无权限等要求 | 原型准确引用及确认/缺口 |
|
|
168
193
|
| --- | --- | --- | --- | --- | --- |
|
|
169
|
-
| `{PAGE等稳定ID}` | `{引用功能/第3章}` | `{引用对象,不复制物理字段字典}` | `{引用第6章}` | `{已有要求或Q}` | `{
|
|
194
|
+
| `{PAGE等稳定ID}` | `{引用功能/第3章}` | `{引用对象,不复制物理字段字典}` | `{引用第6章}` | `{已有要求或Q}` | `{引用ID;实际路径或URL;版本/固定提交;页面/交互范围;实际采用与未决。未形成注明,不预填路径}` |
|
|
170
195
|
|
|
171
196
|
布局、视觉及交互由原型表达;本 PRD 仍维护产品规则与完整行为。原型反馈改变业务规则时回到本处修订;认可原型不能自动改写未批准需求。
|
|
172
197
|
|
|
173
198
|
| 协作/事件/智能能力 | 发生条件与业务输入输出 | 责任方/权威事实 | 失败、人工介入与禁止边界 | 来源/采用状态 |
|
|
174
199
|
| --- | --- | --- | --- | --- |
|
|
175
|
-
| `{实际需要的渠道/事件/能力}` | `{不因工具存在而新增}` | `{
|
|
200
|
+
| `{实际需要的渠道/事件/能力}` | `{不因工具存在而新增}` | `{pbcId/prdId/外部主体;跨EBC时标明ebcId}` | `{具体表现或Q}` | `{明示/候选/不适用及理由}` |
|
|
176
201
|
|
|
177
202
|
## 8. 质量、身份、审计与跨主题依赖
|
|
178
203
|
|
|
@@ -233,8 +258,23 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件,并提供业务边
|
|
|
233
258
|
| S10 | 开放问题绑定具体行为/AC及受限交接范围;冲突双方保留,不择一当事实 | `{第9章}` |
|
|
234
259
|
| S11 | 上游或本PRD规则变化已追踪到受影响行为/AC及下游复核,不静默沿用旧AC或旧确认 | `{0.2/第9/10章}` |
|
|
235
260
|
| S12 | 完整有效行为集合可从0.3定位;上下文、比较与本次目标分开,缺项不冒充完整,旧条目不被误复活 | `{0.3/4.2及逐条来源}` |
|
|
236
|
-
| S13 | 技术实现进入AD
|
|
237
|
-
| S14 | 共用G01—G08逐项核对,身份、来源、版本、范围、变更、认可和单一权威均有实际记录 | `{
|
|
261
|
+
| S13 | 技术实现进入AD;原型/AD/TestCase及T2工程SPEC→T3原Plan分范围交接明确;不越过有效规格、原方法认可和执行条件 | `{10.3及真实缺口}` |
|
|
262
|
+
| S14 | 共用G01—G08逐项核对,身份、来源、版本、范围、变更、认可和单一权威均有实际记录 | `{本模板10.2.1的逐项位置与结果}` |
|
|
263
|
+
|
|
264
|
+
### 10.2.1 共用检查 G01—G08
|
|
265
|
+
|
|
266
|
+
这些是内容核对项,不是审批字段或自动通过状态。逐项填写真实位置、来源和结果,不仅勾选编号。
|
|
267
|
+
|
|
268
|
+
| 编号 | 必须保留的要求 |
|
|
269
|
+
| --- | --- |
|
|
270
|
+
| G01 | 文档、能力、主题、版本及实际位置可定位;未绑定如实写,不猜项目或主题 |
|
|
271
|
+
| G02 | 明示、推导、真实确认、冲突、演练假设分别表达;候选不自动变确定 |
|
|
272
|
+
| G03 | 全量核对目标、价值、角色、范围、场景、附件、质量及明确排除,不只读场景摘要 |
|
|
273
|
+
| G04 | 输入及附件可回读,版本矛盾照录、缺附件登记、不自动取最新;真实已读范围有依据 |
|
|
274
|
+
| G05 | 当前有效目标、上下文、比较基准及真实实现/生产现状分开;保留需求不证明代码可复用 |
|
|
275
|
+
| G06 | 修订先读旧稿及人工修改,保留原件、理由、影响;无变化不加版本,模板/方法变化不自动重建或重放外部动作 |
|
|
276
|
+
| G07 | 认可绑定实际修订、范围、参与者、时间及固定记录;模板、业务、开工、生产认可分别表达,不预填批准/实现/测试通过 |
|
|
277
|
+
| G08 | 规则和执行状态各有单一权威;缺口限制具体依赖范围,不造平行状态表或任务数据库 |
|
|
238
278
|
|
|
239
279
|
### 10.3 分范围交接
|
|
240
280
|
|
|
@@ -243,15 +283,8 @@ PRD 承接原 SPEC 的目标、用户和可测成功条件,并提供业务边
|
|
|
243
283
|
| 原型 | `{本PRD固定版、完整有效功能/AC、适用设计规则}` | `{缺失规则、实际验证和具体版本人审}` |
|
|
244
284
|
| AD | `{选定PRD版、功能/数据/权限/质量定义及原型}` | `{真实工程基线、精确契约与技术风险}` |
|
|
245
285
|
| TestCase | `{选定PRD版、产品预期与适用AD/原型}` | `{技术判据、环境/候选和实际执行条件}` |
|
|
246
|
-
| Plan | `{本PRD选定版的完整有效行为/AC、8.1依赖、4.3产品影响与回归输入}` | `{
|
|
286
|
+
| T2工程SPEC→T3原Plan | `{本PRD选定版的完整有效行为/AC、8.1依赖、4.3产品影响与回归输入}` | `{T2须结合准确AD、采用规范、适用TestCase等落实六项并交审;T3读取选定工程SPEC交原规划,PRD单独交接不代表可计划或可开工}` |
|
|
247
287
|
|
|
248
288
|
本次结论:`{设计草稿/可交接具体范围/尚不可交接范围及理由;不得用文档已生成代替可编码或已验收。}`
|
|
249
289
|
|
|
250
|
-
本结论不改写继承 Skill
|
|
251
|
-
|
|
252
|
-
### 模板修订
|
|
253
|
-
|
|
254
|
-
| 版本 | 日期 | 内容与边界 |
|
|
255
|
-
| --- | --- | --- |
|
|
256
|
-
| v0.0.3 | 2026-10-17 | 补Feature/Story与逐条有效来源、冻结/联调依赖时点、必需路径调整确认;恢复S01—S14逐项核对及产品回归/Plan输入。仅模板文档修订,不自动迁移业务实例或改原Skill/命令。 |
|
|
257
|
-
| v0.0.4 | 2026-10-17 | 清理历史迁移说明依赖,直接使用本模板的行为卡、AC 与交接检查。全部有效内容和 S01—S14 要求保留;不自动迁移业务实例或改原 Skill/命令。 |
|
|
290
|
+
本结论不改写继承 Skill 或命令的输出、触发、工具、验证和审批合同;实际认可按本 Skill与原方法保留人审停点,Plan、CONSTRAINTS、ADR、实际测试和报告等辅助产物继续按适用方法维护。
|