@xulthekl/team-flow 0.22.4

package/prd/v1/prd.md

@@ -0,0 +1,580 @@
+# team-flow_完善产品研发工作流_协作协议层设计
+
+## 一、版本修订记录
+
+### 1.1 版本信息
+
+| 文档状态 | 编辑中 | | |
+|---|---|---|---|
+| 产品版本 | v1 | | |
+| 文档编号 | TF-PRD-2026-001 | | |
+| 撰写人 | LT (Product Authority) | | |
+| 撰写日期 | 2026/07/20 | | |
+
+### 1.2 修订记录
+
+| 版本号 | 修订日期 | 修订内容 | 修订人 |
+|---|---|---|---|
+| v1.0 | 2026/07/20 | 初始版本，ce-brainstorm 产出 | LT / CC |
+
+## 二、业务流程一览
+
+本次迭代新增/更新业务流程（含子流程）如下：
+
+| L1流程分类 | L2流程分组 | L3业务流程 | L4子流程 | 利益相关 | 价值描述 | 流程名称 | 流程描述 | 变更类型 | 关联系统 | 关联需求编号 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|---|---|
+| 研发工作流 | 协作协议层 | TF-COLLAB-001 | / | 开发团队 | 统一 skill 间数据流转和衔接 | Skill 协作协议流程 | 为 17 个 skill 建立声明式 Schema + Handoff 模板协作机制 | 新增 | team-flow plugin | TF-2026-001 | 覆盖四套子系统 |
+| 研发工作流 | 协作协议层 | TF-COLLAB-001 | TF-COLLAB-001-S1 | 开发团队 | PRD 产出标准化 | PRD 对齐子流程 | ce-brainstorm 产出 PRD 格式到 prd/vN/prd.md，支持可配置模板 | 新增 | ce-brainstorm skill | TF-2026-001-S1 | Phase 1 交付物 |
+| 研发工作流 | 协作协议层 | TF-COLLAB-001 | TF-COLLAB-001-S2 | 开发团队 | 工件契约机器可解析 | Schema 协议子流程 | 每个 skill 声明 input/output schema，建立工件契约 | 新增 | 全部 17 个 skill | TF-2026-001-S2 | Phase 2 交付物 |
+| 研发工作流 | 协作协议层 | TF-COLLAB-001 | TF-COLLAB-001-S3 | 开发团队 | 决策点交互优化 | Handoff + DP 优化子流程 | 标准化 handoff 文件，优化 8 个 DP 信息展示 | 新增 | DP-0 ~ DP-7 | TF-2026-001-S3 | Phase 3 交付物 |
+
+## 三、D7.1_业务流程
+
+### 3.1 业务流程图
+
+#### 3.1.1 Skill 协作协议层整体流程
+
+##### 3.1.1.1 业务流程图：
+
+| TF-COLLAB-001_Skill协作协议层整体流程 |
+|---|
+| 需求探索 (need-explorer) → PRD 生成 (ce-brainstorm) → 实施计划 (ce-plan) → 架构设计 (architecture-design) → 原型验证 (prototype) → Spec 编写 (spec-writer) → 代码构建 (build-executor) → 代码审查 (code-reviewer) → 变更合并 (spec-merger) → 复利回写 (release-archivist) |
+
+##### 3.1.1.2 流程概要说明：
+
+team-flow 插件包含 17 个 skill，覆盖产品研发全流程。四套独立体系（team-flow 9 个 skill、compound-engineering 6 个 skill、architecture-design 1 个 skill、prototype 1 个 skill）已拼合到一个 plugin.json 中，但 skill 之间的协作依赖隐式约定，缺少统一协作协议层。本次迭代旨在建立 Schema 声明式协议 + Handoff 模板的混合协作机制。
+
+##### 3.1.1.3 流程步骤说明：
+
+**步骤 1：PRD 对齐（Phase 1）**
+- 改造 ce-brainstorm 使其读取可配置 PRD 模板（`prd.template` 配置字段）
+- 产出 PRD 文档写入 `prd/vN/prd.md`（vN 为产品迭代版本）
+- ce-brainstorm 启动时扫描 `prd/` 目录检测已有迭代版本
+
+**步骤 2：Schema 协议层（Phase 2）**
+- 每个 skill 的 SKILL.md frontmatter 增加 `input_schema` 和 `output_schema` 字段
+- `input_schema` 声明消费的工件列表：`artifact`（文件名）、`required`（必须性）、`schema_ref`（JSON Schema 引用）
+- `output_schema` 声明产出工件，额外包含 `consumed_by` 字段声明下游消费者
+- 在 `team-flow/schemas/` 目录下维护关键衔接点的 JSON Schema 定义
+
+**步骤 3：Handoff + DP 优化（Phase 3）**
+- 每个 skill 完成时生成标准 `handoff.yaml`（字段：`from_skill`、`to_skill`、`timestamp`、`artifacts`、`context_summary`、`dp_digest`）
+- 四套子系统衔接点使用专用 handoff 变体（`bridge_type` 字段区分）
+- 每个 DP 触发 skill 从上游 handoff 自动提取结构化摘要
+
+#### 3.1.2 四套子系统衔接边界
+
+##### 3.1.2.1 业务流程图：
+
+| TF-COLLAB-001-S2_四套子系统衔接 |
+|---|
+| compound-engineering (ce-brainstorm/ce-plan/ce-compound/ce-ideate/ce-proof/ce-strategy) ↔ bridge: ce-plan → spec-writer ↔ team-flow (spec-writer/spec-merger/build-executor/code-reviewer/workflow-start/contract-builder/e2e/bug-investigator/release-archivist) ↔ bridge: architecture-design → build-executor ↔ architecture-design (architecture-design) ↔ bridge: prototype → execution-contract ↔ prototype (prototype) |
+
+##### 3.1.2.2 流程概要说明：
+
+四套子系统的核心衔接点：
+1. **ce-plan → spec-writer**：ce-plan 的实施计划需要无缝交接给 spec-writer 启动 change
+2. **architecture-design → build-executor**：架构设计产出需要指导 build-executor 的代码生成
+3. **prototype → execution-contract**：原型验证结果需要体现在 execution-contract 中
+
+##### 3.1.2.3 流程步骤说明：
+
+| 衔接点 | 上游 Skill | 下游 Skill | 交接工件 | 当前问题 | 改善方案 |
+|---|---|---|---|---|---|
+| ce-plan → spec-writer | ce-plan | spec-writer | prd/vN/prd.md (enriched) | 缺少显式 handoff，用户手动转述 | handoff.yaml 含 PRD 引用 + context_summary |
+| architecture-design → build-executor | architecture-design | build-executor | design.md | 设计约束缺少结构化传递 | input_schema 声明 design.md 约束 |
+| prototype → execution-contract | prototype | contract-builder | prototype/ + execution-contract.md | 原型验证结果与执行契约脱节 | handoff.yaml 含 bridge_type: prototype |
+
+### 附录：业务流程台账（台账建议新建文档保存）
+
+| L1流程分类 | L2流程分组 | L3业务流程 | L4子流程 | 利益相关 | 价值描述 | 流程名称 | 流程描述 | 变更类型 | 关联系统 | 关联需求编号 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|---|---|
+| 研发工作流 | 协作协议层 | TF-COLLAB-001 | / | 开发团队 | 统一协作机制 | Skill 协作协议流程 | Schema + Handoff 混合协议 | 新增 | team-flow | TF-2026-001 | |
+
+## 四、D7.2_画面原型及设计
+
+### 4.1 交互原型
+
+#### 4.1.1 协作协议层
+
+##### 4.1.1.1 【Schema 声明格式】入口：
+
+| 编号 | 画面 | 原型 | 概要说明 |
+|---|---|---|---|
+| TF-P0_SchemaDecl | Schema 声明格式 | {原型截图} | 1. 概述：每个 SKILL.md 的 frontmatter 中增加 input_schema 和 output_schema 声明<br>2. 原型版本：V1.0<br>3. 责任人：LT<br>4. 使用对象：Skill 开发者、工作流维护者<br>5. 流程编号：TF-COLLAB-001-S2<br>6. 活动编号：TF-COLLAB-001-S2_A1<br>7. 修订理由：初始设计<br>8. 原型设计链接（如有）：待补充<br>9. UI 设计稿链接：N/A（CLI/配置层交互） |
+
+##### 4.1.1.2 【Handoff 文件格式】入口：
+
+| 编号 | 画面 | 原型 | 概要说明 |
+|---|---|---|---|
+| TF-P0_HandoffFmt | Handoff 文件格式 | {原型截图} | 1. 概述：标准 handoff.yaml 文件格式，含 from_skill/to_skill/timestamp/artifacts/context_summary/dp_digest 字段<br>2. 原型版本：V1.0<br>3. 责任人：LT<br>4. 使用对象：Skill 执行引擎、DP 触发器<br>5. 流程编号：TF-COLLAB-001-S3<br>6. 活动编号：TF-COLLAB-001-S3_A1<br>7. 修订理由：初始设计<br>8. 原型设计链接（如有）：待补充<br>9. UI 设计稿链接：N/A |
+
+##### 4.1.1.3 【DP 信息展示优化】入口：
+
+| 编号 | 画面 | 原型 | 概要说明 |
+|---|---|---|---|
+| TF-P0_DPDisplay | DP 信息展示 | {原型截图} | 1. 概述：DP-0 ~ DP-7 决策点的信息展示模板，从 handoff 自动提取精炼摘要<br>2. 原型版本：V1.0<br>3. 责任人：LT<br>4. 使用对象：决策参与者<br>5. 流程编号：TF-COLLAB-001-S3<br>6. 活动编号：TF-COLLAB-001-S3_A2<br>7. 修订理由：初始设计<br>8. 原型设计链接（如有）：待补充<br>9. UI 设计稿链接：N/A |
+
+### 4.2 画面迁移
+
+#### 4.2.1 协作协议层画面迁移
+
+| 画面迁移图 | 概要说明 |
+|---|---|
+| {迁移图截图} | 1. 概述：当前 skill 隐式协作 → Schema 声明 + Handoff 显式协作的迁移路径<br>2. 版本：V1.0<br>3. 责任人：LT<br>4. 使用对象：Skill 开发者<br>5. 流程编号：TF-COLLAB-001<br>6. 活动编号：TF-COLLAB-001-S1_A1, TF-COLLAB-001-S2_A1, TF-COLLAB-001-S3_A1<br>7. 修订理由：初始设计 |
+
+### 4.3 信息结构图
+
+| 信息结构图 | 概要说明 |
+|---|---|
+| {结构图截图} | 1. 概述：协作协议层的信息结构 — Schema 声明（per-skill）→ Handoff 文件（per-execution）→ DP 摘要（per-decision-point）的三层结构<br>2. 版本：V1.0<br>3. 责任人：LT<br>4. 使用对象：架构师、Skill 开发者<br>5. 流程编号：TF-COLLAB-001<br>6. 活动编号：全部活动<br>7. 修订理由：初始设计 |
+
+## 五、D7.3_报表清单
+
+### 5.1 报表清单
+
+本次迭代新增/更新报表如下：
+
+| 编号 | 关联流程 | 关联活动 | 关联任务 | 关联需求 | 类型 | 报表名称 | 报表描述 | 更新时间 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|
+| {X.X.X.X_a1_r1} | {流程编号} | {活动编号} | {任务编号} | {需求编号} | {新增/变更} | {名称} | {描述} | {日期} | |
+
+> **说明：** 本次迭代为基础设施/协议层改造，不涉及业务报表。保留模板占位符。
+
+### 5.2 报表台账
+
+| 编号 | 关联流程 | 关联活动 | 关联任务 | 关联需求 | 类型 | 报表名称 | 报表描述 | 更新时间 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|
+| {X.X.X.X_a1_r1} | {流程编号} | {活动编号} | {任务编号} | {需求编号} | {新增/变更} | {名称} | {描述} | {日期} | |
+
+## 六、D7.4_业务术语字典
+
+### 6.1 业务术语字典
+
+本次迭代新增/更新术语字典如下：
+
+| 序号 | 术语名称 | 定义 | 词性 | 同义词/近义词 | 来源 | 更新时间 | 备注 |
+|---|---|---|---|---|---|---|---|
+| 1 | Schema 声明式协议 | 每个 skill 在 SKILL.md frontmatter 中声明其消费和产出的工件列表及结构约束的协议机制 | 名词 | 工件契约、IO Schema | team-flow 设计 | 2026/07/20 | |
+| 2 | Handoff 模板 | skill 完成时生成的标准化交接文件（handoff.yaml），包含 from_skill、to_skill、artifacts、context_summary 等字段 | 名词 | 交接文件、handoff 文件 | team-flow 设计 | 2026/07/20 | |
+| 3 | DP (Decision Point) | 决策点，产品工作流中的门禁节点，共 8 个（DP-0 到 DP-7），用于在关键阶段进行人工决策确认 | 名词 | 决策门禁 | team-flow 设计 | 2026/07/20 | |
+| 4 | 状态机 (8态) | team-flow 工作流的 8 个核心状态：exploring → specifying → bridging → approved-for-build → executing → debugging → closing → abandoned | 名词 | 工作流状态 | team-flow | 2026/07/20 | 状态定义不变 |
+| 5 | bridge_type | handoff 文件中标识四套子系统间衔接类型的字段，用于区分不同衔接点的交接协议 | 名词 | 衔接类型 | team-flow 设计 | 2026/07/20 | |
+| 6 | dp_digest | handoff 文件中包含的决策点摘要字段，供下游 DP 触发 skill 自动提取精炼信息 | 名词 | 决策摘要 | team-flow 设计 | 2026/07/20 | |
+| 7 | team-flow | team-flow 的核心变更链路子系统，包含 9 个 skill（spec-writer, spec-merger, build-executor, code-reviewer, workflow-start, contract-builder, e2e, bug-investigator, release-archivist） | 名词 | 变更链路、spec 体系 | team-flow | 2026/07/20 | |
+| 8 | compound-engineering | team-flow 的头脑风暴→PRD→复利子系统，包含 6 个 skill（ce-brainstorm, ce-plan, ce-compound, ce-ideate, ce-proof, ce-strategy） | 名词 | 复合工程、ce 体系 | compound-engineering | 2026/07/20 | |
+
+### 6.2 业务术语字典台账（台账建议新建文档保存）
+
+| 序号 | 术语名称 | 定义 | 词性 | 同义词/近义词 | 来源 | 更新时间 | 备注 |
+|---|---|---|---|---|---|---|---|
+| 1 | {术语} | {定义} | {词性} | {近义词} | {来源} | {日期} | |
+
+> **说明：** 完整术语台账建议新建独立文档维护，与 CONCEPTS.md 保持同步。
+
+## 七、D7.5_系统功能清单
+
+### 7.1 系统功能清单
+
+本次迭代新增/更新系统功能如下：
+
+| 编号 | 关联流程 | 关联活动 | 类型 | 功能名称 | 功能描述 | 上层功能 | 变更类型 | 变更内容 | 更新时间 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|---|
+| TF-F001 | TF-COLLAB-001-S1 | TF-COLLAB-001-S1_A1 | 新增 | PRD 模板可配置 | ce-brainstorm 读取 prd.template 配置字段指定模板路径，未配置时使用默认模板 | 协作协议层 | 新增 | PRD 模板读取逻辑 | 2026/07/20 | Phase 1 |
+| TF-F002 | TF-COLLAB-001-S1 | TF-COLLAB-001-S1_A1 | 新增 | PRD 输出路径标准化 | ce-brainstorm 产出 PRD 文档写入 prd/vN/prd.md 而非 docs/plans/ | 协作协议层 | 新增 | 输出路径变更 | 2026/07/20 | Phase 1 |
+| TF-F003 | TF-COLLAB-001-S1 | TF-COLLAB-001-S1_A2 | 新增 | 迭代版本自动检测 | ce-brainstorm 启动时扫描 prd/ 目录检测已有迭代版本，自动建议或创建新迭代 | 协作协议层 | 新增 | 版本检测逻辑 | 2026/07/20 | Phase 1 |
+| TF-F004 | TF-COLLAB-001-S1 | TF-COLLAB-001-S1_A3 | 新增 | PRD 元数据适配 | 元数据从 artifact_contract:ce-unified-plan/v1 替换为 PRD 相关元数据（project_name, iteration_version, prd_template） | 协作协议层 | 新增 | 元数据格式变更 | 2026/07/20 | Phase 1 |
+| TF-F005 | TF-COLLAB-001-S1 | TF-COLLAB-001-S1_A4 | 新增 | PRD 章节结构对齐 | ce-brainstorm 产出从 Goal Capsule + Product Contract 改为 PRD 模板 11 章结构 | 协作协议层 | 新增 | 章节映射逻辑 | 2026/07/20 | Phase 1 |
+| TF-F006 | TF-COLLAB-001-S2 | TF-COLLAB-001-S2_A1 | 新增 | input_schema 声明 | 每个 SKILL.md frontmatter 增加 input_schema 字段，声明消费的工件列表（artifact, required, schema_ref） | 协作协议层 | 新增 | frontmatter 扩展 | 2026/07/20 | Phase 2 |
+| TF-F007 | TF-COLLAB-001-S2 | TF-COLLAB-001-S2_A1 | 新增 | output_schema 声明 | 每个 SKILL.md frontmatter 增加 output_schema 字段，声明产出工件及下游消费者（consumed_by） | 协作协议层 | 新增 | frontmatter 扩展 | 2026/07/20 | Phase 2 |
+| TF-F008 | TF-COLLAB-001-S2 | TF-COLLAB-001-S2_A2 | 新增 | JSON Schema 定义维护 | 在 team-flow/schemas/ 目录下维护关键衔接点的 JSON Schema 定义文件 | 协作协议层 | 新增 | schema 文件管理 | 2026/07/20 | Phase 2 |
+| TF-F009 | TF-COLLAB-001-S3 | TF-COLLAB-001-S3_A1 | 新增 | 标准 Handoff 文件生成 | 每个 skill 完成时生成 handoff.yaml（from_skill, to_skill, timestamp, artifacts, context_summary, dp_digest） | 协作协议层 | 新增 | handoff 生成逻辑 | 2026/07/20 | Phase 3 |
+| TF-F010 | TF-COLLAB-001-S3 | TF-COLLAB-001-S3_A1 | 新增 | bridge_type 衔接变体 | 四套子系统衔接点使用专用 handoff 变体，通过 bridge_type 字段区分 | 协作协议层 | 新增 | handoff 变体机制 | 2026/07/20 | Phase 3 |
+| TF-F011 | TF-COLLAB-001-S3 | TF-COLLAB-001-S3_A2 | 新增 | DP 信息展示优化 | 每个 DP 触发 skill 从上游 handoff 自动提取结构化摘要，生成精炼的 DP 展示信息 | 协作协议层 | 新增 | DP 信息模板 | 2026/07/20 | Phase 3 |
+
+### 7.2 系统功能台账
+
+| 编号 | 关联流程 | 关联活动 | 类型 | 功能名称 | 功能描述 | 上层功能 | 变更类型 | 变更内容 | 更新时间 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|---|
+| {X.X.X.X_a1_f1} | {流程编号} | {活动编号} | {新增} | {功能名} | {描述} | {/或上级功能名} | {新增/变更} | {变更内容} | {日期} | |
+
+## 八、D7.6_系统功能处理说明书
+
+### 8.1 系统功能清单
+
+本次迭代新增/更新系统功能如下：
+
+| 编号 | 关联流程 | 关联活动 | 类型 | 功能名称 | 功能描述 | 上层功能 | 变更类型 | 变更内容 | 更新时间 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|---|
+| TF-F001 ~ TF-F011 | TF-COLLAB-001 | 全部 | 新增 | 协作协议层全部功能 | 见 §7.1 系统功能清单 | 协作协议层 | 新增 | 见 §7.1 | 2026/07/20 | |
+
+### 8.2 全局说明
+
+#### 8.2.1 权限说明
+
+**说明：本次迭代为协议层改造，不涉及登录/权限体系变更。**
+
+#### 8.2.2 交互说明
+
+**说明：本次迭代的交互发生在 CLI 层面（skill 执行引擎 + 用户确认），不涉及 GUI 交互。**
+
+##### 8.2.2.1 键盘交互
+
+略
+
+##### 8.2.2.2 画面交互
+
+| 画面 | 画面名称 | 交互触发 | 画面切换 | 备注 |
+|---|---|---|---|---|
+| {画面截图} | {名称} | {触发方式} | {切换结果} | |
+
+> **说明：** 无 GUI 画面交互。
+
+##### 8.2.2.3 弹层交互
+
+| 画面 | 画面名称 | 交互触发 | 弹层交互 | 备注 |
+|---|---|---|---|---|
+| {画面截图} | {名称} | {触发方式} | {弹层效果} | |
+
+> **说明：** 无弹层交互。
+
+#### 8.2.3 异常状态
+
+| 画面 | 画面名称 | 异常状态 | 备注 |
+|---|---|---|---|
+| {画面截图} | {名称} | {异常描述} | |
+
+> **说明：** 异常状态将在实施计划阶段详细定义（如：schema 校验失败、handoff 文件缺失、模板路径无效等）。
+
+#### 8.2.4 其他机制与规则
+
+##### 8.2.4.1 排序规则
+
+略
+
+##### 8.2.4.2 搜索规则
+
+略
+
+##### 8.2.4.3 加载机制
+
+| 画面 | 画面名称 | 加载说明 | 备注 |
+|---|---|---|---|
+| ce-brainstorm 启动 | PRD 模板加载 | 读取 prd.template 配置，未配置时使用默认 templates/prd.md | |
+| ce-brainstorm 启动 | 迭代版本检测 | 扫描 prd/ 目录，检测已有 vN 迭代 | |
+| skill 执行完成 | Handoff 生成 | 生成 handoff.yaml 到 .superpowers/sdd/handoffs/ | |
+
+#### 8.2.5 动效说明
+
+略（CLI 层面无动效需求）
+
+#### 8.2.6 画面加载顺序
+
+略（CLI 层面无画面加载顺序需求）
+
+### 8.3 硬件及网络说明
+
+**说明：本次迭代为协议层/配置层改造，不涉及硬件和网络需求。** 保留模板占位符。
+
+#### 8.3.1 硬件设备（移动端/大屏端）
+
+##### 8.3.1.1 运行环境
+
+{设备运行环境说明}
+
+| {设备类型}品牌/型号 | {设备}系统 | {设备}系统版本 | 备注 |
+|---|---|---|---|
+| {品牌型号} | {系统名} | {版本要求} | |
+
+##### 8.3.1.2 分辨率及屏幕适配
+
+{屏幕适配说明}
+
+| {设备}品牌与型号 | 屏幕尺寸（对角线，mm） | 分辨率（宽x高，px） | 适配策略 | 备注 |
+|---|---|---|---|---|
+| {品牌型号} | {尺寸} | {分辨率} | {适配策略} | |
+
+#### 8.3.2 硬件交互（移动端/大屏端）
+
+{硬件交互说明}
+
+| 权限类型 | 描述 | 必要性说明 | 示例应用场景 |
+|---|---|---|---|
+| {权限名} | {描述} | {必要性} | {场景} |
+
+#### 8.3.3 硬件网络
+
+{网络异常处理说明}
+
+| 序号 | 场景 | 提示方式 | 提示文案 | 提示说明 | 备注 |
+|---|---|---|---|---|---|
+| 1 | {场景} | {页面/toast/弹窗} | {文案} | {说明} | |
+
+#### 8.3.4 预加载内容
+
+{预加载/缓存策略说明}
+
+| 类型 | 预加载内容描述 | 预加载内容描述 | 清除规则 |
+|---|---|---|---|
+| {临时存储/固定存储} | {内容名} | {内容描述} | {清除规则} |
+
+### 8.4 功能模块详细说明
+
+#### 8.4.1 Phase 1：PRD 对齐
+
+##### 8.4.1.1 PRD 模板可配置
+
+| 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
+|---|---|---|---|---|---|
+| TF-F001 | PRD 模板可配置 | N/A（配置文件） | TF-COLLAB-001-S1_A1 | 配置字段：prd.template → 模板文件路径 | ce-brainstorm 通过 `tf runtime config --get prd.template` 读取配置 |
+
+##### 8.4.1.2 PRD 输出路径标准化
+
+| 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
+|---|---|---|---|---|---|
+| TF-F002 | PRD 输出路径标准化 | N/A | TF-COLLAB-001-S1_A1 | 输出路径：prd/{ITERATION_VERSION}/prd.md | 替代 docs/plans/ 路径 |
+
+##### 8.4.1.3 迭代版本自动检测
+
+| 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
+|---|---|---|---|---|---|
+| TF-F003 | 迭代版本自动检测 | N/A | TF-COLLAB-001-S1_A2 | 扫描 prd/ 目录 → vN 版本列表 → 建议最新版本 → 用户确认 | 扫描 → 建议 → 确认流程 |
+
+##### 8.4.1.4 PRD 元数据适配
+
+| 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
+|---|---|---|---|---|---|
+| TF-F004 | PRD 元数据适配 | N/A | TF-COLLAB-001-S1_A3 | 移除 artifact_contract/artifact_readiness/product_contract_source；新增 project_name/iteration_version/prd_template | 元数据字段替换 |
+
+##### 8.4.1.5 PRD 章节结构对齐
+
+| 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
+|---|---|---|---|---|---|
+| TF-F005 | PRD 章节结构对齐 | N/A | TF-COLLAB-001-S1_A4 | 映射：对话信息 → PRD 11 章；§1 元数据自动填充，§2-§4/§6-§8 对话填充，§5/§9-§11 占位保留 | 参见 prd-mapping.md |
+
+#### 8.4.2 Phase 2：Schema 协议层
+
+##### 8.4.2.1 Schema 声明机制
+
+| 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
+|---|---|---|---|---|---|
+| TF-F006 | input_schema 声明 | N/A | TF-COLLAB-001-S2_A1 | frontmatter 字段：input_schema: [{artifact, required, schema_ref}] | 17 个 skill 的 SKILL.md 扩展 |
+| TF-F007 | output_schema 声明 | N/A | TF-COLLAB-001-S2_A1 | frontmatter 字段：output_schema: [{artifact, required, schema_ref, consumed_by}] | 17 个 skill 的 SKILL.md 扩展 |
+| TF-F008 | JSON Schema 定义维护 | N/A | TF-COLLAB-001-S2_A2 | team-flow/schemas/ 目录下的 .json schema 文件 | 关键衔接点的 schema 定义 |
+
+#### 8.4.3 Phase 3：Handoff + DP 优化
+
+##### 8.4.3.1 Handoff 机制
+
+| 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
+|---|---|---|---|---|---|
+| TF-F009 | 标准 Handoff 文件 | N/A | TF-COLLAB-001-S3_A1 | handoff.yaml: {from_skill, to_skill, timestamp, artifacts, context_summary, dp_digest} | 每个 skill 执行完成后生成 |
+| TF-F010 | bridge_type 衔接变体 | N/A | TF-COLLAB-001-S3_A1 | bridge_type 字段区分：ce-plan→spec-writer / architecture→build / prototype→contract | 四套子系统衔接点专用 |
+
+##### 8.4.3.2 DP 信息展示优化
+
+| 编号 | 系统功能 | 原型/UI | 关联活动 | 信息结构 | 画面说明 |
+|---|---|---|---|---|---|
+| TF-F011 | DP 信息展示优化 | N/A | TF-COLLAB-001-S3_A2 | 从 handoff 自动提取 → 精炼摘要 → DP 展示模板 | DP-0 ~ DP-7 共 8 个决策点 |
+
+### 8.5 非功能性需求说明
+
+#### 8.5.1 性能需求
+
+| 编号 | 模块 | 响应时间 | 吞吐量 | 并发用户数 |
+|---|---|---|---|---|
+| 1 | PRD 模板加载 | < 100ms | N/A | N/A |
+| 2 | 迭代版本检测 | < 500ms（目录扫描） | N/A | N/A |
+| 3 | Handoff 文件生成 | < 200ms | N/A | N/A |
+
+#### 8.5.2 可用性需求
+
+| 维度 | 可用性 | 需求内容 |
+|---|---|---|
+| 向后兼容 | 高 | 不改现有 skill 内部结构，仅在 frontmatter 扩展声明字段 |
+| 渐进部署 | 高 | 三阶段独立部署，每阶段可单独验证 |
+| 回退能力 | 高 | 如 handoff 文件生成失败，不阻塞 skill 正常执行 |
+
+#### 8.5.3 安全性需求
+
+| 大类 | 小类 | 需求内容 |
+|---|---|---|
+| {大类} | {小类} | {需求描述} |
+
+> **说明：** 本次迭代为内部协议层改造，暂无特殊安全性需求。
+
+### 8.6 埋点说明
+
+**说明：** 本次迭代暂不涉及埋点。保留模板占位符。
+
+| 事件编号 | 统计事件埋点路径 |
+|---|---|
+| 1 | {埋点路径} |
+
+### 8.7 编码规则
+
+**说明：** 本次迭代暂不涉及特殊编码规则。保留模板占位符。
+
+| 编码类型 | 编码类型 | 规则描述 | 示例 |
+|---|---|---|---|
+| {序号} | {编码类型名} | {规则描述} | {示例} |
+
+## 九、D7.7_要件定义自查报告
+
+### 9.1 产品设计方案自查清单
+
+> **说明：** 要件定义自查报告属于 BA 自查工具，将在 PRD 文档完成后的评审阶段由 BA 角色填充。brainstorm 阶段保留模板占位符。
+
+#### 9.1.1 账户/角色相关
+
+自查结果：**◎**：自查通过 **○**：不涉及 **✕**：自查不通过
+
+| 编号 | 大类 | 小类 | 明细 | 内容 | 结果 | 备注 |
+|---|---|---|---|---|---|---|
+| 1 | {大类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
+
+#### 9.1.2 数据相关
+
+| 编号 | 大类 | 中类 | 小类 | 明细 | 内容 | 结果 | 备注 |
+|---|---|---|---|---|---|---|---|
+| 1 | {大类} | {中类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
+
+#### 9.1.3 状态/交互
+
+| 编号 | 大类 | 小类 | 明细 | 内容 | 结果 | 备注 |
+|---|---|---|---|---|---|---|
+| 1 | {大类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
+
+#### 9.1.4 硬件与网络
+
+| 编号 | 大类 | 中类 | 小类 | 明细 | 内容 | 结果 | 备注 |
+|---|---|---|---|---|---|---|---|
+| 1 | {大类} | {中类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
+
+#### 9.1.5 其他
+
+| 编号 | 大类 | 小类 | 明细 | 内容 | 结果 | 备注 |
+|---|---|---|---|---|---|---|
+| 1 | {大类} | {小类} | {明细} | {检查内容} | {◎/○/✕} | |
+
+#### 9.1.6 用户体验
+
+| 编号 | 大类 | 明细 | 内容 | 结果 | 备注 |
+|---|---|---|---|---|---|
+| 1 | {大类} | {明细} | {检查内容} | {◎/○/✕} | |
+
+#### 9.1.7 产品整体框架
+
+| 编号 | 大类 | 明细 | 内容 | 结果 | 备注 |
+|---|---|---|---|---|---|
+| 1 | {大类} | {明细} | {检查内容} | {◎/○/✕} | |
+
+#### 9.1.8 流程设计
+
+| 编号 | 大类 | 明细 | 内容 | 结果 | 备注 |
+|---|---|---|---|---|---|
+| 1 | {大类} | {明细} | {检查内容} | {◎/○/✕} | |
+
+#### 9.1.9 要件阅读体验
+
+| 编号 | 大类 | 明细 | 内容 | 结果 | 备注 |
+|---|---|---|---|---|---|
+| 1 | {大类} | {明细} | {检查内容} | {◎/○/✕} | |
+
+## 十、D7.8_要件定义完成报告
+
+### 10.1 项目概述
+
+#### 10.1.1 项目背景
+
+> **说明：** 要件定义完成报告属于完成态产物，将在 PRD 评审完成后填充。brainstorm 阶段保留模板占位符。
+
+- 项目背景：{项目的起源、目的和重要性}
+
+- 项目目标：{主要目标和预期成果}
+
+- 项目范围：{工作范围，包括哪些功能、模块或服务被包含在内}
+
+#### 10.1.2 项目需求及目标达成
+
+检查结果：**◎**：达成 **✕**：未达成
+
+| 编号 | 需求名称 | 需求描述 | 目标 | 功能实现 | 设计是否达成目标 | 完成时间 | 期望上线时间 |
+|---|---|---|---|---|---|---|---|
+| 1 | {需求名} | {描述} | {目标} | {实现内容} | {◎/✕} | {日期} | {日期} |
+
+### 10.2 成果物完整性自查
+
+检查结果：**◎**：通过 **○**：不涉及 **✕**：不通过
+
+| 编号 | 分组 | 类型 | 成果物构成 | 成果物 | 数量（份） | 版本 | 是否完整 |
+|---|---|---|---|---|---|---|---|
+| 1 | {分组} | {类型} | {构成} | {成果物名称} | {数量} | {版本} | {◎/○/✕} |
+
+### 10.3 要件自查结果
+
+检查结果：**◎**：通过 **○**：不涉及 **✕**：不通过
+
+| 编号 | 自查内容 | 自查项数量 | 结果 | 备注 |
+|---|---|---|---|---|
+| 1 | {自查内容} | {数量} | {◎/○/✕} | |
+
+### 10.4 对应体制
+
+#### 10.4.1 项目体制
+
+| 编号 | 分组 | 角色 | 主要职责 | 姓名 | 电话 | 备注 |
+|---|---|---|---|---|---|---|
+| 1 | {分组} | {角色} | {职责} | {姓名} | {电话} | |
+
+#### 10.4.2 要件流转
+
+检查结果：**◎**：已完成 **○**：不涉及 **✕**：未流转
+
+| 编号 | 分组 | 类型 | 成果物构成 | 成果物 | 数量（份） | 版本 | 是否流转 | 流转时间 |
+|---|---|---|---|---|---|---|---|---|
+| 1 | {分组} | {类型} | {构成} | {成果物名称} | {数量} | {版本} | {◎/○/✕} | {日期} |
+
+#### 10.4.3 后续工作日程（草案）
+
+| 编号 | 角色 | 事项 | 预计推进时间 | 负责人 | 备注 |
+|---|---|---|---|---|---|
+| 1 | {角色} | {事项} | {日期} | {姓名} | |
+
+### 10.5 总结
+
+1. **需求定义阶段**
+    - 需求收集：{需求收集阶段描述}
+    - 需求判定：{需求判定阶段描述}
+
+2. **需求分析阶段**
+    - 需求细化：{需求细化阶段描述}
+    - 需求验证：{需求验证阶段描述}
+
+3. **要件定义阶段**
+    - 文档构成：{文档结构描述}
+    - 编写内容：{编写内容描述}
+    - 评审与修改：{评审修改描述}
+    - 定稿发布：{定稿发布描述}
+
+4. **要件审查阶段**
+    - 成果物自查：{成果物自查描述}
+    - 要件自查：{要件自查描述}
+
+## 十一、D7.9_评审会议纪
+
+| 评审记录表 | | | | |
+|---|---|---|---|---|
+| **项目** | team-flow 协作协议层 | | | |
+| **领域** | 研发工作流 | **评审时间** | {日期} | |
+| **评审地点** | {地点} | | | |
+| **评审资料** | 1、《PRD: 完善产品研发工作流 - 协作协议层设计》<br>2、《Skill 协作协议层设计 - Plan》<br>3、《templates/prd.md》 | | | |
+| **评审内容概要** | 1、Schema 声明式协议 + Handoff 模板混合策略方案评审<br>2、PRD 对齐改造方案（Phase 1）<br>3、三阶段实施计划可行性 | | | |
+| **参与评审人员** | | | | |
+| **姓名（应参会）** | **姓名（实际参会）** | **部门角色** | **评审意见** | **指摘** |
+| {姓名} | {姓名} | {部门角色} | {同意/有条件同意} | {数量} |
+| **评审指摘建议** | | | | |
+| **序号** | **指摘/问题内容（纳入评审管理一览）** | | **对应时间** | **对应人** |
+| {序号} | {内容} | | {时间} | {姓名} |
+| **评审结论** | | | | |
+| {评审结论描述} | | | | |

package/scripts/check-update.mjs

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+// scripts/check-update.mjs — compare local team-flow version with npm latest
+import { existsSync, readFileSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+
+function readLocalVersion() {
+  const candidates = ['package.json', 'plugin.json'];
+  for (const file of candidates) {
+    const path = join(process.cwd(), file);
+    if (existsSync(path)) {
+      try {
+        const json = JSON.parse(readFileSync(path, 'utf-8'));
+        if (json.name === 'team-flow' && json.version) {
+          return json.version;
+        }
+      } catch { /* ignore */ }
+    }
+  }
+  return null;
+}
+
+function readInstalledPluginVersion() {
+  // Try to detect the globally installed Claude Code plugin version
+  const home = process.env.HOME || process.env.USERPROFILE;
+  if (!home) return null;
+  const pluginPaths = [
+    join(home, '.claude', 'plugins', 'team-flow@team-flow', 'plugin.json'),
+    join(home, '.claude', 'plugins', 'team-flow', 'plugin.json'),
+  ];
+  for (const path of pluginPaths) {
+    if (existsSync(path)) {
+      try {
+        const json = JSON.parse(readFileSync(path, 'utf-8'));
+        if (json.version) return json.version;
+      } catch { /* ignore */ }
+    }
+  }
+  return null;
+}
+
+function readNpmLatest() {
+  try {
+    const out = execFileSync('npm', ['view', 'team-flow', 'version'], {
+      encoding: 'utf-8',
+      timeout: 10_000,
+    });
+    return out.trim();
+  } catch {
+    return null;
+  }
+}
+
+function compareVersions(a, b) {
+  const pa = a.split('.').map(Number);
+  const pb = b.split('.').map(Number);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const na = pa[i] || 0;
+    const nb = pb[i] || 0;
+    if (na > nb) return 1;
+    if (na < nb) return -1;
+  }
+  return 0;
+}
+
+function main() {
+  const localVersion = readInstalledPluginVersion() || readLocalVersion();
+  const latestVersion = readNpmLatest();
+
+  if (!localVersion || !latestVersion) {
+    console.log('⚠️  Could not determine local or latest version. Skipping update check.');
+    process.exit(2);
+  }
+
+  const cmp = compareVersions(localVersion, latestVersion);
+  if (cmp >= 0) {
+    console.log(`✅ team-flow is up to date (${localVersion}).`);
+    process.exit(0);
+  }
+
+  console.log(`⚠️  A new version of team-flow is available: ${latestVersion} (current: ${localVersion})`);
+  console.log('');
+  console.log('Upgrade commands:');
+  console.log('  Claude Code: /plugin update team-flow@team-flow');
+  console.log('  Cursor:      re-run the install-cursor.mjs script');
+  console.log('  WorkBuddy:   npx team-flow@latest install-workbuddy');
+  console.log('  npm:         npm install -g team-flow@latest');
+  process.exit(1);
+}
+
+main();