opencode-workflow/skills/architecture-research/README.zh-TW.md

1.2 KiB
Raw Permalink Blame History

架構研究 (Architecture Research) 技能指南

概述

architecture-research 是可選的前置工作,用來在嚴格 Architect Pipeline 開始前調查技術環境、現有系統限制與可比較架構。此技能只做研究,不做設計,產出為內部分析而非檔案。

輸入與輸出

輸入

  • docs/prd/{feature}.md

輸出

  • 無檔案產出,僅供內部分析使用

界線:研究 vs 設計

此技能嚴格限定為研究。它只能:

  • 彙編限制:現有系統限制、服務邊界、資料流、技術棧、整合依賴
  • 列出選項:可用技術選項、架構模式及其取捨
  • 呈現取捨:候選方案的優缺點,不做最終選擇

此技能嚴禁

  • 做最終架構決策
  • 選擇技術棧
  • 定義服務邊界
  • 定義 API 合約或資料模型
  • 寫 ADR
  • 推薦單一方案

界線很簡單:研究彙編可能選項;設計決定我們建什麼。

研究重點

  • 現有 codebase 架構
  • 系統限制:延遲需求、規模預期、合規需求
  • 可比較系統架構
  • 技術選項的取捨

不應做的事

  • 不做架構設計
  • 不做技術選型
  • 不做最終架構決策
  • 不產生任何檔案