@xulthekl/team-flow 0.61.0 → 0.63.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/.claude/always/phase-guard.md +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.cursor-plugin/marketplace.json +1 -1
- package/.cursor-plugin/plugin.json +1 -1
- package/.github/plugin/marketplace.json +2 -2
- package/AGENTS.md +6 -4
- package/CHANGELOG.md +60 -0
- package/GEMINI.md +1 -1
- package/INSTALL.md +1 -1
- package/README.md +2 -2
- package/agents/prd-completeness-reviewer.md +49 -11
- package/agents/prd-writer.md +47 -13
- package/docs/README_en.md +1 -1
- package/docs/decision-points.md +29 -0
- package/docs/team-flow /344/275/277/347/224/250/350/257/264/346/230/216/357/274/210/347/240/224/345/217/221/345/233/242/351/230/237/347/211/210/357/274/211.md" +6 -6
- package/gemini-extension.json +1 -1
- package/hooks/session-start +2 -2
- package/llms.txt +1 -1
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/scripts/check-project-config.mjs +52 -1
- package/scripts/guard/checks/contract-fresh.mjs +48 -4
- package/scripts/guard/checks/gates-probed.mjs +175 -0
- package/scripts/guard/guard.mjs +17 -2
- package/scripts/lib/cmd-config.mjs +9 -5
- package/scripts/lib/cmd-prd.mjs +225 -0
- package/scripts/lib/cmd-state.mjs +4 -0
- package/scripts/lib/cmd-version.mjs +3 -1
- package/scripts/lib/config-loader.mjs +39 -0
- package/scripts/lib/state-loader.mjs +12 -0
- package/scripts/lib/template-hash.mjs +95 -0
- package/scripts/team-flow.mjs +1 -0
- package/skills/build-executor/SKILL.md +6 -11
- package/skills/build-executor/references/wave-delivery-selfcheck.md +92 -0
- package/skills/ce-brainstorm/SKILL.md +91 -27
- package/skills/ce-brainstorm/references/brainstorm-sections.md +26 -8
- package/skills/ce-brainstorm/references/evidence-chain-validation.md +1 -1
- package/skills/ce-brainstorm/references/prd-84-authoring-spec.md +182 -0
- package/skills/ce-brainstorm/references/prd-mapping.md +9 -4
- package/skills/ce-brainstorm/references/prototype-loop.md +2 -2
- package/skills/code-reviewer/SKILL.md +4 -0
- package/skills/contract-builder/SKILL.md +21 -0
- package/skills/contract-builder/references/bridging-gate-dry-run.md +89 -0
- package/skills/contract-builder/references/freeze-and-errata.md +81 -0
- package/skills/prototype/references/orchestration-flow.md +1 -1
- package/skills/release-archivist/SKILL.md +9 -0
- package/skills/spec-writer/SKILL.md +3 -0
- package/skills/spec-writer/references/facts-referencing.md +64 -0
- package/skills/workflow-orchestrator/SKILL.md +1 -1
- package/skills/workflow-orchestrator/references/feedback-loops.md +10 -5
- package/skills/workflow-orchestrator/references/s2-prd-prototype-loop.md +3 -3
- package/skills/workflow-orchestrator/references/state-model.md +1 -1
- package/skills/workflow-start/SKILL.md +1 -0
- package/templates/prd-brainstorm-profile.md +9 -3
- package/templates/prd.md +76 -49
|
@@ -82,13 +82,13 @@ PRD草稿生成后:
|
|
|
82
82
|
|
|
83
83
|
**orchestrated 路径下完整性评审由编排层在此派发**(standalone 路径由 ce-brainstorm Phase 3.5 内部派发,见 ce-brainstorm `references/prototype-loop.md` §3.5.5)。
|
|
84
84
|
|
|
85
|
-
- 派发:按名派发插件 agent `prd-completeness-reviewer`(6 维,含 §8.4
|
|
86
|
-
- 判定:PASS / PASS_WITH_WARNINGS → 进入步骤 4 冻结;**FAIL(Critical>0:D1/D2
|
|
85
|
+
- 派发:按名派发插件 agent `prd-completeness-reviewer`(6 维,含 §8.4 信息齐备性与业务可读形态 D6),传入 `prd_path` + `concepts_path`(可选)+ `template_path`(默认**插件内置** `templates/prd.md`)+ **`spec_path`**(默认 `${CLAUDE_PLUGIN_ROOT}/skills/ce-brainstorm/references/prd-84-authoring-spec.md`,§8.4 规范唯一权威)+ `detail_ledger_path`(如有)。
|
|
86
|
+
- 判定:PASS / PASS_WITH_WARNINGS → 进入步骤 4 冻结;**FAIL(Critical>0:D1/D2 缺失、D6 核心信息缺失、D6 悬空功能)→ 回 ce-brainstorm Phase 1.3/Phase 3 修订后重审**。D6 形态核验(G7)命中判 Important,不直接触发 FAIL,但须记录并交人工裁定。
|
|
87
87
|
- **适用性**:需要原型(步骤 3 完成后)与不需要原型(纯后端无 UI,步骤 2 后)两条路径**均必须派发**——不因跳过原型循环而跳过完整性评审。
|
|
88
88
|
|
|
89
89
|
### 4. 冻结
|
|
90
90
|
|
|
91
|
-
设置 `frozen_downstream`(见 state-model.md
|
|
91
|
+
设置 `frozen_downstream`(见 state-model.md「双层冻结」)。冻结后,**迭代内变更不升版**——**正文就地更新为最新态**(不累积历史),决策与变更记录写入 `requirement/vN/dialogue-log.md`(PRD 侧只留 §1.2 一行摘要)。
|
|
92
92
|
|
|
93
93
|
### 4.5 阶段产物同步门禁点(v0.37.0 §68.2 G1)
|
|
94
94
|
|
|
@@ -141,7 +141,7 @@ S1 判定「原型补跑/重跑」(PRD `frozen_downstream` ∧ `prototype/`
|
|
|
141
141
|
- **制品保留**:S3 `plan.md` / S4 `changes/` 已存在且仍有效则**保留不动**,不重做、不归档。
|
|
142
142
|
- **闭环恢复**:原型循环闭环(自动评审 PASS / 人工通过)后,`workflow_phase` 恢复原 phase(如 `s4-distribution`),S2 状态回 `completed`(去掉 `prototype-only` 子标记)。
|
|
143
143
|
- **replan_log 必写**:`{ seq, trigger: "prototype-rerun", before: <原 phase>, after: "S2(prototype-only)", approved_by }`,并记结论「未暴露 scope 问题、changes 保持有效」。
|
|
144
|
-
- **升级路径**:若原型循环暴露 PRD scope 问题 → **脱离本路径**,升级为 S3→S2 回退修订(临时解除 `frozen_downstream
|
|
144
|
+
- **升级路径**:若原型循环暴露 PRD scope 问题 → **脱离本路径**,升级为 S3→S2 回退修订(临时解除 `frozen_downstream`;**PRD vN 就地更新为最新态** + 变更记录写 `dialogue-log.md`),不再按 prototype-only 处理。
|
|
145
145
|
|
|
146
146
|
## change_dag 结构
|
|
147
147
|
|
|
@@ -88,6 +88,7 @@ Validate mode against artifact content. If hotfix/tweak criteria not met → upg
|
|
|
88
88
|
- **返回即验证(validation gate)**:子代理返回产物后**立即** `tf validate <change-dir>`;FAIL → SendMessage 回**原**子代理修复,通过后才能继续/转换。把格式失败拦截在返回时,而非状态转换时(避免浪费整次执行后再失败)。**build-executor 附加验证(v0.13 §52 B3,SDD/full 模式)**:返回的 diff 中必须包含测试文件(src/test/ 或项目测试目录);零测试文件的实现返回一律 BLOCK,SendMessage 回原子代理按 test-matrix.md / TDD Iron Law 补齐——不得以"手动验证"替代(C1-domain-policy 事件教训)。例外:已显式记录 `test_matrix_skipped=true` + 理由的 change(纯文档/配置类)不要求测试文件
|
|
89
89
|
- **结果协议**:子代理终态须标注 `FINAL VERDICT: <DONE|BLOCKED|FAIL>`(审查类用 PASS/PASS_WITH_WARNINGS/FAIL);**SendMessage 报告为权威结果**,task-notification.result 仅内部元数据
|
|
90
90
|
- **子代理状态边界**:子代理 MUST NOT 修改 `.team-flow.yaml` 的 `state`/`workflow` 核心字段(状态转换是主代理专有职责,经 `tf state transition` 执行),只写自己的 `dp_N_*` 决策字段
|
|
91
|
+
- **环境清单注入(v0.63.0;feedback 20260923-013114 S6)**:dispatch 前检查 `.team-flow/environment.md` 是否存在——**存在则全文附入 dispatch prompt**。该文件承载**机器级事实**(grep=ugrep shim → 扫描一律 `command grep`;`tf` CLI 来自 npm 全局包而非插件缓存;Eclipse JDT 写 `target/` → Maven 必须带 `clean`;node 版本可直跑 ui 测试等),避免每个子代理 prompt 重复教学、且防止它们在不知情下踩坑。**嵌套 dispatch 同样注入**:注入时**必须在清单全文之后追加一句元指令**——「请将本清单原样继续附入你的所有下游 dispatch」——因为收到的是清单全文、不是这条规则本身,而子代理不继承主代理的 skills;仅在 workflow-start 侧声明不够(规则到不了第二跳)。(与 `conventions/` 分层互补:conventions = 项目级规范、可跨机器共享;environment = 机器级事实、不入库、不污染他机。)
|
|
91
92
|
|
|
92
93
|
### Route to need-explorer
|
|
93
94
|
Change is fuzzy, scope unclear, comparing options, no stable change name.(交互式澄清,主进程执行,见 Sub-agent Dispatch Protocol)
|
|
@@ -14,15 +14,21 @@ Phase 2 产出的每个方案必须覆盖核心维度,按需覆盖扩展维度
|
|
|
14
14
|
| 数据关系 | §4.3 信息结构图 | 核心业务实体之间的关联规则是什么?实体间的层级/归属/引用关系? |
|
|
15
15
|
| 业务规则 | §8.2.4 其他机制与规则 | 排序规则?搜索规则?加载机制?异常处理?校验逻辑? |
|
|
16
16
|
| 系统功能 | §7 D7.5 系统功能清单 | 需要哪些功能点?每个功能点关联哪个业务流程/活动? |
|
|
17
|
-
|
|
|
17
|
+
| 功能细节 | §8.4 功能模块详细说明 | UI 功能:这个画面给谁用?展示哪些内容?能做什么操作?什么情况下会失败或不允许?非 UI 功能:什么情况下触发?输入什么、产出什么?出错时怎么办? |
|
|
18
18
|
|
|
19
|
-
> **功能细节澄清分级(v0.
|
|
19
|
+
> **功能细节澄清分级(v0.62.0)**:按功能复杂度分级——Standard/Deep scope **逐条澄清业务信息**
|
|
20
|
+
> (谁用 / 展示什么 / 能做什么 / 失败怎么办,或 何时触发 / 输入输出 / 出错怎么办),
|
|
21
|
+
> Lightweight scope 简化澄清(需求已足够清晰时)。澄清产出 **detail_ledger**
|
|
22
|
+
> (逐功能 → 已澄清 / 待澄清 / NA),作为 §8.4 撰写数据源 + prd-completeness-reviewer D6 核对基准。
|
|
23
|
+
>
|
|
24
|
+
> **边界**:澄清的是**业务信息本身**,**不是**「正文该写成什么样」——
|
|
25
|
+
> 形态由 `prd-84-authoring-spec.md` 规定,不在澄清环节讨论。
|
|
20
26
|
|
|
21
27
|
## 扩展思考维度(按需触发)
|
|
22
28
|
|
|
23
29
|
| 维度 | 触发条件 | 对应 PRD 章节 | 引导问题 |
|
|
24
30
|
|------|---------|-------------|---------|
|
|
25
|
-
| 画面设计 | 涉及 UI 交互 | §4 D7.2 |
|
|
31
|
+
| 画面设计 | 涉及 UI 交互 | §4 D7.2 | 画面结构如何?页面间如何迁移?(视觉层面辅助,功能细节见核心维度「功能细节」) |
|
|
26
32
|
| 业务术语 | 出现领域专有名词 | §6 D7.4 | 哪些术语需要统一定义?有无同义词? |
|
|
27
33
|
| 报表需求 | 用户提到"报表/统计/分析" | §5 D7.3 | 需要哪些报表?关联哪些流程和数据? |
|
|
28
34
|
| 交互机制 | 有特殊交互需求 | §8.2.2 | 键盘/画面/弹层交互细节? |
|
package/templates/prd.md
CHANGED
|
@@ -15,9 +15,15 @@
|
|
|
15
15
|
|
|
16
16
|
### 1.2 修订记录
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
> **本节只记录「文档整体变更要点」的一句话摘要**。**逐条评审意见、决策依据与过程讨论一律见 `dialogue-log.md`**,本节不承载。
|
|
19
|
+
|
|
20
|
+
| 版本号 | 修订日期 | 修订要点(摘要) | 修订人 |
|
|
19
21
|
|---|---|---|---|
|
|
20
|
-
| {版本} | {日期} | {
|
|
22
|
+
| {版本} | {日期} | {一句话摘要} | {姓名} |
|
|
23
|
+
|
|
24
|
+
> **约束(撰写与审查同判)**:① 单版本行要点 **≤ 200 字**;
|
|
25
|
+
> ② **禁止**在旧版本行追加「已被 X 推翻 / 本行 ③ 已被 R2 推翻」式**反转注记**——补丁累积正是要消灭的;
|
|
26
|
+
> ③ 功能级历史、决策依据、澄清过程一律迁 `dialogue-log.md`,本节只留最新态行。
|
|
21
27
|
|
|
22
28
|
## 二、业务流程一览
|
|
23
29
|
|
|
@@ -25,7 +31,11 @@
|
|
|
25
31
|
|
|
26
32
|
| L1流程分类 | L2流程分组 | L3业务流程 | L4子流程 | 利益相关 | 价值描述 | 流程名称 | 流程描述 | 变更类型 | 关联系统 | 关联需求编号 | 备注 |
|
|
27
33
|
|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
28
|
-
| {分类} | {分组} | {编号} | {子流程编号或/} | {相关方} | {价值} | {名称} | {描述} | {
|
|
34
|
+
| {分类} | {分组} | {编号} | {子流程编号或/} | {相关方} | {价值} | {名称} | {描述} | {本期新增/本期变更/本期不变} | {系统名} | {编号} | |
|
|
35
|
+
|
|
36
|
+
> **「变更类型」列为受控枚举**(全文各表同判,含 §7.1 / §8.1 功能清单):只能取 `本期新增` / `本期变更` / `本期不变` 三值。
|
|
37
|
+
> **禁止**写入版本锚点(`v0.5ac`)、澄清轮次锚点(`Q8 新增`)、日期、旧值或变更原因——这些属**演变轨迹**,归 `dialogue-log.md`。
|
|
38
|
+
> 该列服务的是**本期评审的范围认知**(这次动了什么),保留;追述「以前是什么」的内容一律迁出。
|
|
29
39
|
|
|
30
40
|
## 三、D7.1_业务流程
|
|
31
41
|
|
|
@@ -51,7 +61,7 @@
|
|
|
51
61
|
|
|
52
62
|
| L1流程分类 | L2流程分组 | L3业务流程 | L4子流程 | 利益相关 | 价值描述 | 流程名称 | 流程描述 | 变更类型 | 关联系统 | 关联需求编号 | 备注 |
|
|
53
63
|
|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
54
|
-
| {分类} | {分组} | {编号} | {子流程编号或/} | {相关方} | {价值} | {名称} | {描述} | {
|
|
64
|
+
| {分类} | {分组} | {编号} | {子流程编号或/} | {相关方} | {价值} | {名称} | {描述} | {本期新增/本期变更/本期不变} | {系统名} | {编号} | |
|
|
55
65
|
|
|
56
66
|
## 四、D7.2_画面原型及设计
|
|
57
67
|
|
|
@@ -87,13 +97,13 @@
|
|
|
87
97
|
|
|
88
98
|
| 编号 | 关联流程 | 关联活动 | 关联任务 | 关联需求 | 类型 | 报表名称 | 报表描述 | 更新时间 | 备注 |
|
|
89
99
|
|---|---|---|---|---|---|---|---|---|---|
|
|
90
|
-
| {X.X.X.X_a1_r1} | {流程编号} | {活动编号} | {任务编号} | {需求编号} | {
|
|
100
|
+
| {X.X.X.X_a1_r1} | {流程编号} | {活动编号} | {任务编号} | {需求编号} | {本期新增/本期变更/本期不变} | {名称} | {描述} | {日期} | |
|
|
91
101
|
|
|
92
102
|
### 5.2 报表台账
|
|
93
103
|
|
|
94
104
|
| 编号 | 关联流程 | 关联活动 | 关联任务 | 关联需求 | 类型 | 报表名称 | 报表描述 | 更新时间 | 备注 |
|
|
95
105
|
|---|---|---|---|---|---|---|---|---|---|
|
|
96
|
-
| {X.X.X.X_a1_r1} | {流程编号} | {活动编号} | {任务编号} | {需求编号} | {
|
|
106
|
+
| {X.X.X.X_a1_r1} | {流程编号} | {活动编号} | {任务编号} | {需求编号} | {本期新增/本期变更/本期不变} | {名称} | {描述} | {日期} | |
|
|
97
107
|
|
|
98
108
|
## 六、D7.4_业务术语字典
|
|
99
109
|
|
|
@@ -101,15 +111,19 @@
|
|
|
101
111
|
|
|
102
112
|
本次迭代新增/更新术语字典如下:
|
|
103
113
|
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
114
|
+
> **§6 是「业务与代码共享词汇表」**:术语名称用**业务语汇**(PRD 正文主干一律用它);
|
|
115
|
+
> 「代码标识」列是该术语在代码中的对应标识(类名/字段名/枚举值等),**仅供实现侧对齐**,
|
|
116
|
+
> **不得**用代码标识回写正文主干。业务上无对应代码概念的填「—」。
|
|
117
|
+
|
|
118
|
+
| 序号 | 术语名称 | 代码标识 | 定义 | 词性 | 同义词/近义词 | 来源 | 更新时间 | 备注 |
|
|
119
|
+
|---|---|---|---|---|---|---|---|---|
|
|
120
|
+
| 1 | {术语} | {代码标识;无则填「—」} | {定义} | {名词/动词/动词短语} | {近义词} | {来源} | {日期} | |
|
|
107
121
|
|
|
108
122
|
### 6.2 业务术语字典台账(台账建议新建文档保存)
|
|
109
123
|
|
|
110
|
-
| 序号 | 术语名称 | 定义 | 词性 | 同义词/近义词 | 来源 | 更新时间 | 备注 |
|
|
111
|
-
|
|
112
|
-
| 1 | {术语} | {定义} | {词性} | {近义词} | {来源} | {日期} | |
|
|
124
|
+
| 序号 | 术语名称 | 代码标识 | 定义 | 词性 | 同义词/近义词 | 来源 | 更新时间 | 备注 |
|
|
125
|
+
|---|---|---|---|---|---|---|---|---|
|
|
126
|
+
| 1 | {术语} | {代码标识;无则填「—」} | {定义} | {词性} | {近义词} | {来源} | {日期} | |
|
|
113
127
|
|
|
114
128
|
## 七、D7.5_系统功能清单
|
|
115
129
|
|
|
@@ -119,13 +133,13 @@
|
|
|
119
133
|
|
|
120
134
|
| 编号 | 关联流程 | 关联活动 | 类型 | 功能名称 | 功能描述 | 上层功能 | 变更类型 | 变更内容 | 更新时间 | 备注 |
|
|
121
135
|
|---|---|---|---|---|---|---|---|---|---|---|
|
|
122
|
-
| {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {
|
|
136
|
+
| {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {本期新增/本期变更/本期不变} | {变更内容} | {日期} | |
|
|
123
137
|
|
|
124
138
|
### 7.2 系统功能台账
|
|
125
139
|
|
|
126
140
|
| 编号 | 关联流程 | 关联活动 | 类型 | 功能名称 | 功能描述 | 上层功能 | 变更类型 | 变更内容 | 更新时间 | 备注 |
|
|
127
141
|
|---|---|---|---|---|---|---|---|---|---|---|
|
|
128
|
-
| {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {
|
|
142
|
+
| {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {本期新增/本期变更/本期不变} | {变更内容} | {日期} | |
|
|
129
143
|
|
|
130
144
|
## 八、D7.6_系统功能处理说明书
|
|
131
145
|
|
|
@@ -135,10 +149,16 @@
|
|
|
135
149
|
|
|
136
150
|
| 编号 | 关联流程 | 关联活动 | 类型 | 功能名称 | 功能描述 | 上层功能 | 变更类型 | 变更内容 | 更新时间 | 备注 |
|
|
137
151
|
|---|---|---|---|---|---|---|---|---|---|---|
|
|
138
|
-
| {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {
|
|
152
|
+
| {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {本期新增/本期变更/本期不变} | {变更内容} | {日期} | |
|
|
139
153
|
|
|
140
154
|
### 8.2 全局说明
|
|
141
155
|
|
|
156
|
+
> **本期范围(受控句式,须挂 change 级 `proposal.md` 条款号,实现双向可追溯)**:
|
|
157
|
+
> 本期包含:{…}(对应 proposal 条款 {编号});本期不包含:{…}(对应 proposal「范围外(Out of Scope)」条款 {编号})。
|
|
158
|
+
>
|
|
159
|
+
> 范围以 change 级 `proposal.md` 的「范围外(Out of Scope)」为权威;本节只做**一句话交代 + 条款号回指**,
|
|
160
|
+
> **不另立范围章节、不在本节展开讨论**(自由散文无法核对是否与 proposal 一致,故不用)。
|
|
161
|
+
|
|
142
162
|
#### 8.2.1 权限说明
|
|
143
163
|
|
|
144
164
|
**※ 说明本次系统功能需要的权限,若不涉及可以忽略;**
|
|
@@ -267,42 +287,39 @@
|
|
|
267
287
|
|
|
268
288
|
### 8.4 功能模块详细说明
|
|
269
289
|
|
|
270
|
-
|
|
290
|
+
> **撰写规范唯一权威**:插件内置 `prd-84-authoring-spec.md`(**不是本模板**)。
|
|
291
|
+
> 本模板只承载**骨架与填空槽位**。撰写(`prd-writer`)、审查(`prd-completeness-reviewer` D6)
|
|
292
|
+
> 与形态核验一律以规范文件为准;项目内的模板副本**非权威、不得直接读取**。
|
|
293
|
+
>
|
|
294
|
+
> **三句话要点**:① 一个功能模块**一张表(两列)+ 编号业务叙述**;
|
|
295
|
+
> ② 面向**业务评审人**撰写——业务语汇为主干,技术标识符不进正文主干;
|
|
296
|
+
> ③ 完整性走**内部校验清单**,清单本身**不写入正文**(见规范文件 §5)。
|
|
271
297
|
|
|
272
298
|
#### 8.4.1 {模块名称}
|
|
273
299
|
|
|
274
300
|
##### 8.4.1.1 {功能名称}
|
|
275
301
|
|
|
276
|
-
|
|
|
277
|
-
|
|
278
|
-
|
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
- [ ] 触发条件:{定时/事件/手动触发}
|
|
298
|
-
- [ ] 输入输出:{输入参数/输出结果/格式}
|
|
299
|
-
- [ ] 处理步骤:{处理流程/算法/业务规则}
|
|
300
|
-
- [ ] 异常处理:{异常场景/重试/补偿}
|
|
301
|
-
- [ ] 权限角色:{可执行角色/鉴权}
|
|
302
|
-
- [ ] 幂等并发:{幂等性/并发控制}
|
|
303
|
-
- [ ] 性能约束:{耗时/吞吐/资源}
|
|
304
|
-
|
|
305
|
-
> **NA 机制**:维度不适用时标注 `NA + 一句理由`(如 `页面布局:NA,后台批处理无画面`);**未标注 NA 且未覆盖 = 缺失**,审查将判 FAIL。
|
|
302
|
+
| {UI 功能填「原型/UI」;非 UI 功能填「触发入口」} | {业务说明} |
|
|
303
|
+
|---|---|
|
|
304
|
+
| {原型文件与容器定位 / 触发入口描述} | {按下方编号骨架展开} |
|
|
305
|
+
|
|
306
|
+
**1、定义**:{这个功能是什么、给谁用、解决什么问题(1-3 句,业务语汇)}
|
|
307
|
+
|
|
308
|
+
**2、{查询条件 / 触发条件}**:{UI:查询条件与控件;非 UI:什么情况下触发}
|
|
309
|
+
|
|
310
|
+
**3、{列表字段与布局 / 输入与输出}**:{UI:展示哪些字段、什么布局;非 UI:输入什么、产出什么}
|
|
311
|
+
|
|
312
|
+
**4、业务规则**:{逐条写清,含前提条件与例外——本功能最重要的部分}
|
|
313
|
+
|
|
314
|
+
**5、异常与边界**:{按业务风险选取:空态 / 错误态 / 无权限 / 并发 / 极值 / 状态冲突 / 数据缺失 / 外部依赖失败;纯展示类写关键 2-3 项即可,不必逐项罗列}
|
|
315
|
+
|
|
316
|
+
> **可解析性(必守)**:字段类信息须写成「**字段名:控件,规则**」的单行可辨识格式
|
|
317
|
+
> (如 `协议名称:输入框,模糊匹配,最长 50 字符`),**不得**写成跨句散文——
|
|
318
|
+
> 下游 `prototype-reviewer` / `prototype-env-scout` / `builder-methodology` 依赖从本节提取字段。
|
|
319
|
+
|
|
320
|
+
> **语汇**:正文主干用 §6 术语字典的**业务名**;类名 / 方法名 / 表名 / 行号不得出现,确需时以括注附于业务名后。
|
|
321
|
+
> **精确**:禁用弱词(较快 / 友好 / 支持 / 适当 / 等 / 尽可能 / 必要时)——模糊表述会被下游自行解释,产生静默缺陷。
|
|
322
|
+
> **完整性**:11 维 / 7 维清单**降为内部校验清单**,撰写前用它核对信息齐备,撰写时按业务认知顺序重组进正文,**不得**把清单写进正文;不适用维度在 `detail-ledger.md` 标 `NA + 理由`。
|
|
306
323
|
|
|
307
324
|
### 8.5 非功能性需求说明
|
|
308
325
|
|
|
@@ -396,9 +413,19 @@
|
|
|
396
413
|
|
|
397
414
|
#### 9.1.9 要件阅读体验
|
|
398
415
|
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
416
|
+
> **自查项以规范文件为准**:逐条对照 `prd-84-authoring-spec.md` **§8 可读性自查项**填写结果。
|
|
417
|
+
> 本表只列名目与结果,**不重复列出条款正文**——同一规则两处维护必然漂移。
|
|
418
|
+
>
|
|
419
|
+
> **两处声明**:① **自查 ≠ 规格正文**——本节是**撰写者自检清单**,不构成对业务方的规格条款,
|
|
420
|
+
> 判定权仍在业务评审;② **非脚本门禁**——不得将本节接入机械门禁脚本。
|
|
421
|
+
|
|
422
|
+
| 编号 | 自查项(详见规范文件 §8) | 结果 | 备注 |
|
|
423
|
+
|---|---|---|---|
|
|
424
|
+
| 1 | 正文主干无类名 / 方法名 / 表名 / 行号 | {◎/○/✕} | |
|
|
425
|
+
| 2 | 无历史痕迹(删除线、版本锚点、「原口径作废」「已被推翻」) | {◎/○/✕} | |
|
|
426
|
+
| 3 | 术语用 §6 业务名 | {◎/○/✕} | |
|
|
427
|
+
| 4 | 无弱词(规范文件 §4) | {◎/○/✕} | |
|
|
428
|
+
| 5 | 维度清单未写入正文(规范文件 §5) | {◎/○/✕} | |
|
|
402
429
|
|
|
403
430
|
## 十、D7.8_要件定义完成报告
|
|
404
431
|
|