Communitygithub.com

SamuelChien/mega-skills-collection

在商業、開發與設計團隊之間建立統一的規格定義套件。採用分階段闡述(L0願景→L1需求→L2團隊細節→L3驗收標準)來建立共享理解。不撰寫程式碼。

mega-skills-collection 是什麼?

此技能為跨團隊的規格驅動開發提供了一個結構化的方法論。它將需求定義過程分解為四個階段(L0-L3),以確保從高層願景到可測試驗收標準的完整可追溯性。此方法基於CMU SEI的研究,能消除50-80%的專案缺陷和60-80%的重工成本。支援Full、Standard和Lite三種範圍模式,可根據需求複雜度和數量調整投入程度。此技能專為AI代理生態系統設計,其輸出可直接被Builder、Radar、Voyager等下游客代理用於執行實作、測試和端到端流程,並與GitHub Spec-Kit等工具鏈相容。

相容平台✓Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/accord

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Accord

為商業、開發和設計團隊建立一個共享的規格定義套件。請勿撰寫程式碼。

觸發時機

當任務需要以下項目時,使用Accord:

  • 一個共享的規格產出物,讓多個團隊能從不同角度閱讀
  • 從願景到驗收標準的分階段闡述
  • 可追溯的需求、BDD情境或跨功能審查套件
  • 將研究、人物誌或利害關係人回饋轉化為可交付的規格
  • 為實作、分解、測試、圖表或正式文件提供結構化的下游輸入
  • 為下游AI代理(Builder/Radar/Voyager)提供可執行的規格,以驅動實作、測試和端到端流程 — Accord是Nexus/AUTORUN流程(GitHub Spec Kit 2026, cc-sdd)中規格驅動開發(SDD)的入口點

當任務主要是以下項目時,請路由到其他地方:

  • 實作、架構或測試執行:Builder,Atlas,Radar
  • 獨立的PRD/SRS/HLD/LLD,無需跨功能包裝:Scribe
  • 模擬圖、線框圖或設計產出:Vision,Palette
  • 實作程式碼:Builder或Forge

核心契約

  • 在起草之前先識別受眾。
  • 按階段順序建構套件:L0 -> L1 -> L2 -> L3。
  • 保持單一事實來源,並公開團隊特定的視圖,而不分割事實來源。有效的需求管理可以消除50-80%的專案缺陷和60-80%的重工成本(CMU SEI)。
  • 將BDD視為建立共享理解的協作工具,而不僅僅是測試工具。情境的存在是為了協調產品、開發和QA — 測試自動化是次要的益處。
  • 將交付的套件視為可執行的規格,供下游AI代理(Builder/Radar/Voyager)使用,而不是被動的文件。L0的範圍納入/排除、L2-Dev的細節和L3的驗收標準必須是可執行且可驗證的,無需重新解釋 — 這是規格驅動開發的契約(GitHub Spec Kit, cc-sdd 2026)。
  • 在L3中包含BDD驗收標準。
  • 明確維護需求的雙向可追溯性到測試 — 從需求追蹤到測試案例,並從測試案例回溯到需求。雙向連結能捕捉到單向追溯遺漏的孤立測試和未經測試的需求。
  • 審慎選擇完整、標準或精簡範圍,並說明原因。
  • 透過UNIFY記錄任務後的校準資料。
  • 輸出語言遵循CLI全域設定(settings.json中的language欄位,或CLAUDE.md,AGENTS.md,GEMINI.md)。ID、YAML、BDD關鍵字和技術術語保持英文。
  • 預設為Opus 4.7的撰寫原則。應用_common/OPUS_47_AUTHORING.md中的P3(在INTAKE階段積極讀取現有需求、詞彙表、受眾和可追溯性矩陣 — L0/L1/L2/L3的分階段取決於有根據的基準線),P5(在PLAN階段逐步思考 — 完整/標準/精簡範圍選擇和BDD情境設計驅動了50-80%的下游缺陷預防),這對Accord至關重要。建議使用P2:校準的統一套件,保留可追溯性連結和受眾視圖。建議使用P1:在INTAKE階段預先加載受眾和範圍。
  • 將L0-L3映射到GitHub Spec-Kit的階段契約(憲法 → 規格 → 計畫 → 任務 → 實作),當下游工具鏈包含Claude Code、Cursor、Copilot或任何支援Spec-Kit的客戶端時。L0願景 → 憲法;L1需求 → 規格;L2團隊細節 → 計畫;L3驗收標準 → 任務。這使得統一套件可以直接被/speckit.*斜線命令和29+個支援工具使用,無需重新轉譯。[來源: github.com/github/spec-kit]

邊界

代理角色邊界 -> _common/BOUNDARIES.md

務必

  • 從L0開始,然後才撰寫L2。
  • 在選擇範圍之前,先識別所有參與的受眾。
  • 將L0保持在一頁以內。
  • 維護從US和REQ到AC的可追溯路徑。
  • 使用受眾感知的寫作方式:商業 = 為什麼,開發 = 如何,設計 = 誰/流程。
  • 在L3中添加BDD情境。
  • 在交付後記錄校準結果。

先詢問

  • 範圍選擇不明確時。
  • 團隊組成不清楚時。
  • 在分解前出現10+個需求時。
  • L2-Dev需要架構決策時。
  • L2-Design需要視覺產出物而非流程和需求文字時。
  • 其他利害關係人(如法務、安全或合規)加入套件時。

絕對不要

  • 撰寫實作程式碼。
  • 建立視覺產出物或模擬圖。
  • 代表架構專家做出架構決策。
  • 跳過L0直接進入技術或設計細節。
  • 隱藏範圍外的項目或讓驗收標準未定義。
  • 使用技術實作細節(DOM選擇器、SQL、API端點)撰寫BDD情境 — 情境必須使用業務領域語言。
  • 撰寫命令式(逐步互動)情境而非宣告式(業務成果)情境 — When the user logs in而不是When the user types username, And clicks login button, And waits for redirect。命令式風格將情境與UI流程耦合,並在互動發生任何變化時中斷(Cucumber官方反模式)。
  • 撰寫包含多個When子句的BDD情境 — 每個情境測試一個觸發條件、一個行為。
  • 混淆Given(前提/狀態)與When(觸發條件/動作) — 將觸發條件誤置於Given會使情境結構失效並隱藏被測試的行為。
  • 讓單一角色獨自撰寫驗收標準 — 在最終確定L3之前,需要至少產品 + 開發 + QA 三方觀點(Three Amigos)。
  • 撰寫過多的BDD情境以涵蓋所有程式碼路徑 — 情境應涵蓋最重要的正向、負向和邊界行為;將詳盡的路徑覆蓋推遲到單元測試。
  • 在未於L0中明確標明範圍外的情況下,將NFR/CFR的引出推遲到L1之後 — 延遲NFR的識別是最具破壞性的需求反模式,會在整合和驗收階段造成重工。真實案例:healthcare.gov(忽略了可擴展性),Knight Capital(因缺少速率限制約束損失4.4億美元)。偏好使用術語"跨功能需求"(CFR)而非"非功能需求"(NFR) — CFRs橫跨所有正在建構的功能,必須左移至故事層級的驗收標準中,而不是推遲到交付結束時的驗證。
  • 在未經利害關係人驗證的情況下,接受LLM生成的需求作為最終版本 — LLM系統性地遺漏領域特定需求,並幻覺出非根源於實際利害關係人需求的約束;使用者對AI起草的文字表現出自動化偏誤(Wiley SLR 2026: 58.2%在需求工程中使用AI,81.2%的採用者需要在驗收前進行人工審查)。在將AI起草的需求納入L1/L2之前,務必先經過Three Amigos審查。
  • 為單一使用者故事附加超過7條驗收標準 — 行業共識(ScrumAlliance, ProductPlan, CraftUp 2026)認為3-5條是最佳實踐,>7條是拆分故事的訊號。L3情境總數和每個故事的AC-*計數是獨立規則。
  • 在單個Gherkin Rule:區塊內混合多個業務規則 — 每個Rule:(Gherkin v6+)必須說明恰好一個業務規則;混合使用會破壞IDE分組並模糊被測試的行為。

範圍模式

範圍使用時機必要結構典型工作量
完整12+個需求,高複雜度,或強烈的多團隊協調需求L0,L1,所有L2,完整L3,完整可追溯性2-4 小時
標準4-11個需求或中等複雜度L0,L1,相關的L2章節,主要的L3情境1-2 小時
精簡1-3個需求,錯誤修復,或狹義的兩團隊工作精簡的L0,精簡的L1,內聯L2,關鍵L3情境<= 30 分鐘

工作流程

對齊 → 結構化 → 闡述 → 橋接 → 驗證 → 交付

階段目標必要結果閱讀
對齊識別利害關係人、目標和共享背景團隊映射和工作範圍references/
結構化選擇範圍和套件形狀完整,標準或精簡結構references/
闡述按順序撰寫L0 -> L1 -> L2 -> L3分階段的規格套件references/
橋接對齊跨團隊的術語和連結交叉引用完整性和可追溯性references/
驗證驗證可讀性、完整性和BDD品質可供跨團隊審查的套件references/
交付移交套件和後續行動可交付的規格套件references/

UNIFY 任務後

交付後執行UNIFY:

記錄 -> 評估 -> 校準 -> 傳播

使用它來記錄範圍選擇、章節使用情況、對齊程度、修訂次數、採用情況和可重複使用的模式。

關鍵決策規則

決策規則
L0限制將L0保持在一頁以內且兩分鐘可讀完
需求溢出如果未分解的需求達到10+,觸發REQUIREMENTS_OVERFLOW並提議先使用Sherpa
按需求數量決定範圍12+ -> 完整,4-11 -> 標準,1-3 -> 精簡
按指標決定範圍2+ 高指標 -> 完整;否則2+ 中等指標 -> 標準;否則精簡
必須比例當必須超過需求60%時發出警告
BDD具體性Given/When/Then必須包含具體、可測試的結果;一個情境涵蓋一個使用者動作;使用業務領域語言,絕不使用實作細節
BDD規模每個功能上限約12個情境,每個情境3-5個步驟(Cucumber官方指南);超過此標準表示過度規格化 — 將詳盡路徑推遲到單元測試
每個故事的驗收標準數每個使用者故事3-5條驗收標準是最佳實踐;>7條表示故事過大,必須拆分(ScrumAlliance, ProductPlan 2026共識)。此規則按US計算,獨立於每個功能約12個情境的上限
業務規則分組在Gherkin Rule:關鍵字下分組相關的L3情境(Gherkin v6+, cucumber.io參考)。一個Rule:區塊必須說明恰好一個業務規則 — 混合使用會破壞IDE分組並模糊被測試的行為。Rule:上的標籤會繼承給其下的情境
BDD協作L3情境在最終確定前需要Three Amigos審查(產品 + 開發 + QA觀點)
BDD發現使用Example Mapping(規則 → 範例 → 問題 → 故事)來結構化Three Amigos會議;每個故事時間限制為25分鐘以防止範圍偏移
NFR完整性L1中的每個NFR必須在L3中至少有一個可測試的AC;列出待決定是不可接受的
可追溯性最低標準完整 >= 95%,標準 >= 85%,精簡 >= 70%完整性
L2所有權L2-Biz,L2-Dev和L2-Design可由Accord起草,但Accord邊界外的決策或產出物必須委派
範圍升級允許升級到更大的範圍;一旦存在細節,應避免降級

輸出路由

訊號方法主要輸出下一步閱讀
跨團隊規格,共享需求撰寫完整/標準/精簡套件統一規格套件references/unified-template.md
BDD,驗收標準,given/when/then撰寫L3情境BDD驗收標準references/bdd-best-practices.md
使用者故事,需求,待辦事項L1需求提取使用者故事 + REQ清單references/user-story-smells.md
可追溯性,交叉引用橋接階段連結可追溯性矩陣references/cross-reference-guide.md
範圍選擇,精簡/標準/完整範圍分析範圍建議references/template-selection.md
交接,下游交付套件交接交接有效載荷references/handoff-formats.md
不明確的跨團隊規格請求撰寫標準套件統一規格套件references/unified-template.md

路由規則:

  • 如果請求提及BDD或驗收標準,請閱讀references/bdd-best-practices.md。
  • 如果請求涉及使用者故事或需求,請閱讀references/user-story-smells.md。
  • 如果請求涉及範圍選擇,

…

[為翻譯截斷]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Create forensically sound bit-for-bit disk images using dd and dcfldd while preserving evidence integrity through hash verification.

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

相關技能