專案交付物
範本遵循法國整合專案實務(DAT、DEX、MEP 單、驗收記錄),使用英文標題並在括號內保留法文名稱。這些範本為骨架結構:包含標題、表格及需以斜體(_..._)取代或刪除的簡短指引文字。
何時使用哪個範本
| 需求 | 範本 | 主要負責代理 | 貢獻者 | 階段 |
|---|---|---|---|---|
| 描述目標技術解決方案並說明選擇原因 | dat.md | enterprise-architect | infra、dba、devsecops、integration、erp、ibmi | 設計階段,持續更新至上線 |
| 將系統移交給維運 | dex.md | infra-expert | scheduling、dba、integration、ibmi、erp | 建置 → 上線前 |
| 規劃並執行正式上線 | release-sheet.md | project-manager | 所有參與的技術代理 | 每次釋出 |
| 指定兩個系統間的介面 | interface-contract.md | integration-expert | erp、ibmi、dba、devsecops | 設計階段,每次變更版本化 |
| 請求並記錄網路流量 | flow-matrix.md | infra-expert | devsecops、integration | 設計階段 → 防火牆請求 |
| 明確分工 | raci.md | project-manager | 所有人 | 框架設定,每階段審查 |
| 追蹤風險、假設、問題、依賴 | raid.md | project-manager | 所有人 | 整個專案,每週審查 |
| 記錄交付物驗收 | uat-signoff.md | project-manager | 業務負責人、測試人員 | 每次驗收活動結束時 |
| 一次性記錄組織環境事實,供所有專家查閱 | environment-sheet.md | project-manager(經由 /tiger-team:discover) | 所有人 | 專案啟動時,保持最新狀態 |
如何實例化範本
- 在完整路徑下讀取範本(請見下方索引)。
- 在用戶專案中建立實例(若無慣例則詢問位置),例如
docs/<交付物>/<ID>-<簡短名稱>.md;請勿修改範本本身。 - 填入所有
<placeholder>;對於未知資訊,保留TBD(負責人,日期)標記,切勿憑空捏造。 - 一旦填寫完成,刪除斜體的指引行;刪除不適用的選擇性章節,並在審計人員預期看到的位置註明「N/A:<原因>」。
- 與相關交付物交叉檢查一致性(相同的 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-(驗收記錄)、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、驗收記錄、保留事項)。
- 每份完成的文件應易於審查:使用表格而非散文,每行一個事實,無行銷用語。
範本索引
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— UAT 簽收單(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