项目交付物 (Project Deliverables)
模板遵循法国集成项目实践(DAT、DEX、MEP 发布清单、PV 验收报告),采用英文标题并在括号中保留法语名称。模板为骨架结构:包含标题、表格和短斜体指导文字(_..._),需替换或删除。
何时使用哪个模板
| 需求 | 模板 | 典型负责人 | 参与者 | 阶段 |
|---|---|---|---|---|
| 描述目标技术方案并说明选择理由 | dat.md | 企业架构师 | 基础设施、DBA、DevSecOps、集成、ERP、IBMi | 设计阶段,持续更新至上线 |
| 将系统移交给运维团队 | dex.md | 基础设施专家 | 调度、DBA、集成、IBMi、ERP | 构建阶段 → 上线前 |
| 计划并执行生产部署 | release-sheet.md | 项目经理 | 所有参与的技术智能体 | 每个发布 |
| 指定两个系统之间的一个接口 | interface-contract.md | 集成专家 | ERP、IBMi、DBA、DevSecOps | 设计阶段,每次变更版本化 |
| 请求并记录网络流程 | flow-matrix.md | 基础设施专家 | DevSecOps、集成 | 设计阶段 → 防火墙请求 |
| 明确谁负责什么 | raci.md | 项目经理 | 所有人 | 项目框架阶段,每个阶段复查 |
| 跟踪风险、假设、问题、依赖 | raid.md | 项目经理 | 所有人 | 整个项目,每周复查 |
| 记录交付物的验收结果 | uat-signoff.md | 项目经理 | 业务负责人、测试人员 | 每个验收活动结束时 |
| 记录组织环境事实,供所有专家查阅一次 | environment-sheet.md | 项目经理(通过 /tiger-team:discover) | 所有人 | 项目开始阶段,保持更新 |
如何实例化模板
- 读取模板的完整路径(见下方索引)。
- 在用户项目中创建实例(若无约定,询问存放位置),例如
docs/<deliverable>/<ID>-<short-name>.md;切勿修改模板本身。 - 填充每一个
<占位符>;对于未知内容,保留TBD (负责人, 日期)标记,而非自行编造。 - 当某个部分填写完成后,删除其中的斜体指导行;删除不适用的可选部分,并在审计人员期望其存在的地方注明
不适用:原因。 - 交叉检查与相关交付物的一致性(相同的 ID、版本、主机名、负责人)。
编写规则(适用于所有交付物)
- 文档控制优先:标识块、版本表(版本、日期、作者、变更内容)、审阅者和批准人及其日期。版本命名:
0.x草稿,1.0首次批准,1.x小更新,2.0结构性变更。状态:草稿 / 审阅中 / 已批准 / 已废弃。 - 目标受众:在文档顶部说明受众(架构师、运维人员、业务方、审计员、验收委员会),并为其编写内容:运维人员需要命令和阈值,赞助者需要决策和风险。
- 可追溯性:将每个设计元素、测试用例和保留项链接到需求 ID、ADR、工单或 RAID 条目。跨交付物使用稳定的 ID:条目类——
REQ-、ADR-(四位数字,如ADR-0001)、INT-(接口)、FLW-(流程)、JOB-、MON-(监控检查)、KE-(已知错误)、RSK-、ASM-、ISS-、DEP-、TC-、DEF-、RES-(保留项)、PRE-/GNG-/RB-(发布前提条件、启动/不启动检查点、回滚步骤);文档类——DAT-、DEX-、FLM-(流程矩阵)、REL-(发布)、PVR-(PV 验收报告)、RACI-、RAID-。 - 禁止使用真实数据:虚构主机名、文档用 IP 范围(RFC 5737)、机密占位符、合成示例、通用角色名称(而非个人联系方式)。遵守
sector-compliance技能的保密规则;描述保密或受限分发系统的交付物应在受保护环境中编写,而非此处。 - 密级标签:在文档头部放置组织的文敏感性标签(例如:内部、机密);描述生产安全的交付物(流程矩阵、DAT 安全部分)通常至少为机密级别。
- 精确性:日期使用 ISO 8601(如
2026-10-22),时间带时区(如21:30 Europe/Paris),容量带单位和周期(如120 000 条消息/天,峰值 40 条消息/秒),持续时间明确(如RTO 4 小时)。 - 单一数据源:引用其他交付物而非复制其内容(DAT 链接接口合同和流程矩阵;DEX 链接 DAT)。
- 决策与证据:记录谁在何时做了何种决定;交付物作为审计证据(DORA、ACPR、PCI DSS、HDS、验收)。
- 语言:标题使用英文;当法语术语为合同或法规名称时,在括号中保留(如 MEP、PV 验收报告、réserves)。
- 每份填写后的文档保持可审查性:表格优于散文,每条一行事实,避免营销语言。
模板索引
templates/dat.md— 技术架构文档 (Dossier d'Architecture Technique) — 完整路径${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/dat.mdtemplates/dex.md— 运维手册 (Dossier d'Exploitation):运行手册、监控、批处理、备份、重启、联系人、升级策略 — 完整路径${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/dex.mdtemplates/release-sheet.md— 生产发布清单 (Fiche de mise en production, fiche MEP):按时间计划表、负责人、启动/不启动、回滚 — 完整路径${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/release-sheet.mdtemplates/interface-contract.md— 接口合同 (Contrat d'interface):双方、触发条件、传输方式、格式、映射、数据量、SLA、错误处理与重放、安全性、监控、测试 — 完整路径${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/interface-contract.mdtemplates/flow-matrix.md— 网络流程矩阵 (Matrice des flux),含审阅检查清单 — 完整路径${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/flow-matrix.mdtemplates/raci.md— RACI 矩阵 (Matrice RACI) — 完整路径${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/raci.mdtemplates/raid.md— RAID 日志 (Registre des risques, hypothèses, problèmes et dépendances) — 完整路径${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/raid.mdtemplates/uat-signoff.md— 用户验收测试签收 (Procès-verbal de recette):范围、活动总结、缺陷、保留项、决定、签名 — 完整路径${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/uat-signoff.mdtemplates/environment-sheet.md— 环境信息表 (Fiche d'environnement):按领域记录组织环境的事实,附来源和未决问题;存放于docs/tiger-team/environment.md— 完整路径${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/environment-sheet.md