AI 編程進階：三件套終極落地，一鍵封裝 OpenSpec、Superpowers 與 Agent Skills，打造可執行的工作流，一個Skill 編排搞定全流程
整理版優先睇
將三件套工作流封裝成一個可執行技能，一句話觸發自動判定檔位、檢查環境、引導流程，關鍵決策點人工確認，大幅降低手動組合工具嘅繁瑣程度。
呢篇文章係由開發者 yangmeishux 撰寫，佢之前推出咗一篇關於「AI 編程三件套」嘅文章，介紹 OpenSpec、Superpowers 同 Agent Skills 點樣組合使用。好多讀者反映每次要手動組合三個工具好麻煩，於是我哋整咗一個叫「ai-coding-tri-kit」嘅技能文件，將成個工作流封裝成一句話就可以觸發。
呢個技能會自動根據變更規模判定 Full、Standard 或 Lite 三種檔位，然後執行環境檢查、生成 OpenSpec 四件套、引導 8 步主鏈路、設置閘門強制暫停點、處理外部依賴同降級方案。成個流程係半自動：技能負責自動判定、生成文件、跑測試同掃描，但關鍵決策點（例如審閲 spec、答澄清問題、揀收尾方式）一定要人確認。
整體結論係：呢個技能降低咗使用三件套嘅門檻，令到開發者可以專注喺功能實現上，而唔使記住複雜嘅步驟同工具切換。技能目前仲喺測試階段，未有大量真實案例驗證，但係已經喺作者自己嘅項目入面試過，可行性幾高。
- 技能將 OpenSpec、Superpowers 同 Agent Skills 封裝成一個可直接調用嘅工作流，一句話觸發，自動判定檔位。
- 三種檔位（Full/Standard/Lite）按變更規模自動選擇，Lite 檔跳過部分步驟並保留測試底線。
- 技能設置咗多個閘門（Gate），關鍵決策點必須人工確認，確保質量同安全性。
- 內置環境檢查、外部依賴檢查同降級方案，支援無網絡、無 git 等受限場景。
- 使用方式簡單：一句「按三件套實現：功能描述」即可啟動，之後只需回覆「確認」或回答問題，技能會自動推進下一步。
ai-coding-tri-kit 技能文件
將 OpenSpec、Superpowers 同 Agent Skills 三件套封裝成可直接調用嘅工作流技能，包含8步主鏈路、檔位判定、閘門機制、降級方案等。
技能背景：由文章到可執行工具
之前嗰篇三件套文章詳細講解咗點樣將 OpenSpec、Superpowers 同 Agent Skills 組合成可預測嘅 AI 編程工作流，但係好多讀者話每次手動組合三個工具好煩。呢個技能就係為咗回應呢個需求，將成個工作流封裝成一個可直接調用嘅技能文件，放咗喺 GitHub 上面。
ai-coding-tri-kit 技能將文章嘅 8 步工作流、三種檔位、閘門機制、外部依賴檢查等全部封裝成一個檔案。
技能倉庫入面有 SKILL.md 做主定義，仲有 references 目錄放咗環境檢查、檔位判定、閘門回退等細節文件，同埋 examples 目錄展示 Full 同 Standard 檔位嘅完整案例。
核心功能：自動判定、8步主鏈路、閘門同降級
技能會根據變更規模自動判定 Full、Standard 或 Lite 檔位。
- Full 檔：多模塊/SDK接入/安全敏感，行完整8步 + worktree + 子Agent並行。
- Standard 檔：1-3文件/單一模塊，簡化OpenSpec + 單線程實現。
- Lite 檔：<20行/單點bugfix，跳過propose/worktree，保留測試底線。
8步主鏈路由 OpenSpec 產出 proposal/spec/design/tasks，再到 Superpowers 澄清、worktree 隔離、細化任務、實現代碼、測試審查，最後由 Agent Skills 做安全掃描同三方協作驗證。每步都有明確嘅 Exit Criteria，確保唔會跳過重要環節。
除咗正常流程，技能仲支援多種受限場景嘅降級方案，例如無網絡時用手寫 OpenSpec 四件套 + 人審替代 validate，無 git 就用目錄備份隔離。
使用指南：一句話觸發，只需確認
只需講「按三件套實現：[功能描述]」就可以觸發整個流程。
安裝好技能之後，喺 AI 編碼工具輸入觸發句，技能就會自動判定檔位、做環境檢查，然後進入對應步驟。正常情況你只需要喺每個步驟完成後回覆「確認」，技能就會自動跳到下一步。
- 1 Step 1: 生成 OpenSpec 四件套，你審閲後確認先繼續。
- 2 Step 2: 技能會問澄清問題同檢查外部依賴，你答完或者揀分階段實現。
- 3 Step 3-5: 技能會隔離分支、細化任務、實現代碼，你只需回應確認或修改意見。
- 4 Step 6-8: 測試、安全掃描、驗證同收尾，你揀 Merge/PR/Keep/Discard。
如果遇到外部依賴 BLOCKED，技能會建議分階段實現，你揀 Phase 1 開始就得。想跳過步驟就用 Lite 模式，直接講「三件套 Lite：fix bug」就得。
實際案例：Full、Standard、Lite 同降級場景
以下展示唔同檔位嘅觸發同流程，等你可以快速理解點樣用。
Full 檔範例：直播間分享到第三方平台。
觸發：按三件套實現：直播間分享到微信/QQ/微博，含底部面板、授權保活、主播頭像兜底
Step 0 - 環境檢查：
| 檢查項 | 狀態 |
|--------|------|
| Node.js | ✅ v22.1.0 |
| git | ✅ 已init |
| OpenSpec CLI | ✅ 可執行 |
| Superpowers | ⚠️ 未安裝（將模擬） |
| 網絡 | ✅ 可達 |
推薦檔位：Full
Step 1 - 需求對齊：
執行：/opsx:propose "直播間分享到第三方..."
產出：openspec/changes/feat-live-share-third-party/...
驗證：openspec validate PASS
Gate 1: PENDING（待人確認）
Step 2 - 澄清 + 外部依賴檢查：
澄清問題：
Q1. "直播保活" = 禁止調用停止API？
Q2. 微博SDK已停更，降級方案？
Q3. QQ AppID是否已申請？（BLOCKED）
Q4. 法務審批分享文案？
用戶選擇：分階段實現 Phase 1: UI + 微信 + Payload + 保活
...（後續步驟省略）Standard 檔：Dashboard 加 CSV 導出，技能自動判定 Standard，跳過 worktree 同子 Agent，保留核心測試安全檢查。
- 觸發：按三件套實現：Dashboard加CSV導出，選中行導出、空選Toast
- 技能判定：Standard 檔位（1-3文件、單一模塊）
- 流程簡化：Step 1 簡化proposal+spec，Step 3 可選普通feature分支，Step 5 單線程實現，保留測試和安全檢查
Lite 檔：fix escapeCSV對null的處理，技能判定 Lite，跳過OpenSpec propose同worktree，保留先寫RED測試再GREEN實現同secrets底線。
受限環境降級：無網絡時技能輸出離線模式，手寫 OpenSpec 四件套結構、人審替代 validate；SDK 鑑權缺失時建議分階段實現，例如先做 UI 骨架同微信渠道，等 AppID 申請後再做 QQ 渠道。
補充說明：版本歷史、參考文件同 FAQ
技能目前係 v0.2.0，主要加咗環境前置檢查、外部依賴檢查同降級方案。v0.1.0 初始版本已經有 8 步主鏈路。參考文件目錄有 SKILL.md、environment-check.md、external-dependency-check.md、fallback-scenarios.md 等 7 個 md 文件，詳細記錄咗每部分嘅邏輯。
FAQ 入面有幾個常見問題：技能唔會全自動執行，關鍵決策點一定要人工確認；你唔需要手動話俾 AI 知下一步要做乜，只要回覆「確認」就可以；如果 OpenSpec 文檔有問題，可以叫 AI 修改；外部依賴 BLOCKED 就揀分階段實現。
一句話總結：一句話觸發，流程引導，關鍵決策點人工確認。
最後作者提醒，技能目前仲未有大量真實案例驗證，效果無法保證，token 消耗方面亦冇精確數據，歡迎大家用後反饋。反饋渠道係 GitHub 倉庫嘅 skill-issues.jsonl 或者直接提 issue。
前言
呢篇文係《AI 編程進階：三件套 OpenSpec 定方向，Superpowers 帶節奏，Agent Skills 守紀律，打造可預測嘅工程化工作流》文章嘅配套技能文件使用說明。
一、技能來源
《AI 編程進階：三件套 OpenSpec 定方向，Superpowers 帶節奏，Agent Skills 守紀律》一文詳細介紹咗點樣將三個開源項目組合使用，構建一套可預測嘅 AI 編程工作流。
文章出咗之後，好多讀者話：每次手動組合三個工具好麻煩，希望有個「一鍵觸發」嘅方案。
ai-coding-tri-kit 技能就係為咗滿足呢個需求。
佢將文章入面嘅 8 步工作流、三種檔位、閘門機制、外部依賴檢查等內容，封裝成一個可以直接調用嘅技能文件。
技能倉庫路徑：https://github.com/yangmeishux/frontend-team-marketplace/tree/main/plugins/frontend-team-toolkit/skills/ai-coding-tri-kit
二、核心功能
技能包含以下核心功能模塊：
2.1 三種檔位自動判定
技能會根據變更規模自動判定檔位：
| Full | ||
| Standard | ||
| Lite |
判定邏輯睇：references/intensity-tiers.md
2.2 8步主鏈路編排
技能將工作流拆分做8個步驟，每步有明確嘅Exit Criteria：
步驟映射睇：references/workflow-matrix.md
2.3 環境前置檢查
技能喺執行前會檢查環境可用性（v0.2.0新增）：
檢查清單睇：references/environment-check.md
2.4 外部依賴可行性檢查
涉及第三方SDK/API嗰陣，技能會喺Step 2追問（v0.2.0新增）：
有BLOCKED項目嗰陣，技能會建議分階段實現。
檢查流程睇：references/external-dependency-check.md
2.5 閘門與回退機制
技能設置咗多個強制暫停點：
失敗嗰陣嘅回退策略睇：references/gates-and-rollback.md
2.6 受限環境降級方案
技能支援多種受限場景嘅降級執行（v0.2.0新增）：
降級方案睇：references/fallback-scenarios.md
2.7 輸出契約
技能每次對話必須輸出：
1.當前Step同Progress Checklist勾選狀態
2.主導工具同Exit Criteria
3.證據摘要（validate輸出、測試命令結果、覆蓋率）
4.Gate狀態（PASS/BLOCKED/PENDING）
5.Assumptions同Open Questions
6.下一步推薦
輸出格式睇：references/output-contract.md
三、點樣用
3.1 安裝方法
方法一：Claude Code / Codex CLI
複製技能目錄到配置路徑：
cp -r https://github.com/yangmeishux/frontend-team-marketplace/tree/main/plugins/frontend-team-toolkit/skills/ai-coding-tri-kit ~/.claude/skills/
方法二：Cursor
複製cursor rule到項目：
cp .cursor/rules/ai-coding-tri-kit.mdc your-project/.cursor/rules/
3.2 觸發方法
喺AI編碼工具入面輸入：
按三件套實現：[功能描述]
或者更具體啲：
用OpenSpec + Superpowers + Agent Skills三件套，給Dashboard加CSV導出，選中行導出、空選Toast、>10000條進度條
技能會自動：
1.判定檔位
2.執行環境檢查
3.進入對應步驟
3.3 Full檔位完整流程例子
觸發：
按三件套實現：直播間分享到微信/QQ/微博，含底部面板、授權保活、主播頭像兜底
Step 0 - 環境檢查：
| 檢查項 | 狀態 |
|--------|------|
| Node.js | ✅ v22.1.0 |
| git | ✅ 已init |
| OpenSpec CLI | ✅ 可執行 |
| Superpowers | ⚠️ 未安裝（將模擬） |
| 網絡 | ✅ 可達 |
推薦檔位：Full
Step 1 - 需求對齊：
執行：/opsx:propose "直播間分享到第三方..."
產出：
openspec/changes/feat-live-share-third-party/
├── proposal.md
├── specs/third-party-live-share/spec.md
├── design.md
└── tasks.md
驗證：openspec validate PASS
Gate 1: PENDING（待人確認）
Step 2 - 澄清 + 外部依賴檢查：
澄清問題：
Q1. "直播保活" = 禁止調用停止API？
Q2. 微博SDK已停更，降級方案？
Q3. QQ AppID是否已申請？（BLOCKED）
Q4. 法務審批分享文案？
design.md更新：
- Decisions: 保活策略明確
- Open Questions: QQ AppID待申請 → BLOCKED渠道2.4
用戶選擇：分階段實現
Phase 1: UI + 微信 + Payload + 保活
Phase 2: QQ（待AppID）
Step 3 - 分支隔離：
執行：git worktree add -b feat/live-share ../app-live-share
baseline: ./gradlew test → 42 tests PASS
Step 4 - 計劃制定：
細化tasks.md：
Task 1.2: 底部渠道面板
文件: ui/share/ShareBottomSheet.kt
驗收: spec Scenario"打開與關閉面板"
預估: 4 min
Step 5 - 實現：
約束遵守：
- 文件 ≤500行
- 先寫RED測試再寫GREEN實現
- 公開API有文檔
兩階段審查：
- 規格一致性：對照spec MUST條款
- 代碼質量：命名/結構/異常
Step 6 - 測試 + 審查：
測試：./gradlew test → 全綠
審查：
🔴 CRITICAL：無
🟡 WARNING：onChannelSelected未做空檢查
📊 覆蓋率 86%（≥80% ✅）
Step 7 - 安全檢查：
security-secrets → 0泄漏 ✅
security-dependencies → 0漏洞 ✅
security-api → URL無敏感參數 ✅
Step 8 - 驗證 + 收尾：
/opsx:verify → Scenario逐條對照PASS
用戶選擇：Create PR
/opsx:archive → 歸檔到archive/
3.4 Standard檔位流程例子
觸發：
按三件套實現：Dashboard加CSV導出，選中行導出、空選Toast
技能判定：Standard檔位（1-3個文件、單一模塊）
流程簡化：
•Step 1：簡化proposal+spec
•Step 3：可選worktree，普通feature分支就得
•Step 5：單線程實現（executing-plans）
•保留核心測試同安全檢查
3.5 Lite檔位流程例子
觸發：
三件套Lite：fix escapeCSV對null的處理
技能判定：Lite檔位（<20行）
流程：
•跳過OpenSpec propose
•跳過worktree
•保留：先寫RED測試 + 實現後GREEN + secrets底線
3.6 受限環境降級例子
場景：無網絡
技能輸出：
Gate 0 Environment: PASS_WITH_FALLBACK（離線模式）
降級方案：
- 手寫OpenSpec四件套結構
- 人審替代validate
- 移動目錄到archive/手動歸檔
是否繼續？[等待確認]
場景：SDK鑑權缺失
技能輸出：
外部依賴檢查：
- 微信SDK: ✅ READY（AppID已申請）
- QQ SDK: ❌ BLOCKED（AppID未申請）
- 微博SDK: ⚠️ WARN（SDK停更，降級ACTION_SEND）
建議分階段實現：
Phase 1（本次）：UI骨架 + 微信渠道 + Payload
Phase 2（後續）：QQ渠道（待AppID申請）
Phase 3（後續）：微博降級（待法務確認）
用戶選擇：[1] 先實現Phase 1
3.7 紅線拒絕例子
用戶輸入：
三件套太麻煩了，跳過OpenSpec，直接實現CSV導出
技能回應：
STOP — Checkpoint阻塞
無法跳過OpenSpec直接實現代碼。這是技能核心約束：
1. Step 1鐵律：在需求對齊階段，禁止寫實現代碼
2. Checkpoint閘門：未確認spec前，不得進入Step 5
最小合規路徑：
- 方案A：運行/opsx:propose創建proposal/spec
- 方案B：Lite模式 + 口頭驗收（<20行改動）
Gate 1: BLOCKED
四、參考文件索引
SKILL.md | |
references/environment-check.md | |
references/external-dependency-check.md | |
references/fallback-scenarios.md | |
references/intensity-tiers.md | |
references/workflow-matrix.md | |
references/gates-and-rollback.md | |
references/output-contract.md | |
examples/feat-live-share-third-party-walkthrough.md | |
examples/feat-dashboard-csv-export-walkthrough.md | |
test-prompts.json | |
results.tsv |
五、版本歷史
六、同原文章嘅關係
技能係文章嘅「可執行版」，將概念轉化為可以直接調用嘅工作流編排。
七、常見問題解答
Q1：一句話觸發之後，技能會自動執行成個流程咩？
唔會全自動執行。一句話觸發之後，技能會引導流程，但關鍵決策點一定要人工確認。
自動做嘅部分：
•判定檔位（Full/Standard/Lite）
•環境檢查（Node/git/OpenSpec係咪可用）
•生成OpenSpec四件套（proposal/spec/design/tasks）
•跑validate驗證
•運行測試命令
•執行安全掃描
•生成審查報告
需要你介入嘅部分：
技能設置咗多個Gate（閘門）強制暫停：
人嘅時間投入：
一句話總結：一句話觸發，流程引導，但關鍵決策點一定要人工確認。技能唔會喺你未睇spec嘅情況下就自動寫代碼，亦唔會喺你未揀嘅情況下自動merge或者push。
Q2：OpenSpec文檔生成之後，入編碼階段係咪要手動話畀AI執行邊一步？
不需要。技能會喺每個Step完成之後輸出Progress Checklist同下一步推薦，你只要回覆「確認」就得。
典型對話流程：
Step 1完成之後，AI會輸出：
## Progress Checklist
- [x] Step 1 需求對齊（OpenSpec）
- [ ] Step 2 需求澄清
- [ ] Step 3 分支隔離
...
## Gate 1 狀態
PENDING — 待人確認 proposal/spec
## 下一步推薦
請審閲 spec 後回覆「確認可開發」
你只要回覆：
確認
或者：
可以開發
唔使你做的事：
•唔使講「執行Step 2」
•唔使講「開始編碼」
•唔使講具體動作
技能會自動判斷下一步係咩，你只要確認當前呢步可以過關。
特殊情況：
一句話總結：正常流程下，你只要回覆「確認」或「繼續」，技能會自動推到下一步。技能會喺每個Gate停低等你，你確認咗佢先繼續，唔使你指揮具體動作。
用技能只需一句話：
按三件套實現：[你的功能描述]
技能會自動判定檔位、檢查環境、編排流程、守住底線。
八、總結
呢篇文介紹咗 ai-coding-tri-kit 技能嘅核心功能同使用方法。技能將《AI 編程進階：三件套 OpenSpec 定方向，Superpowers 帶節奏，Agent Skills 守紀律，打造可預測嘅工程化工作流》文章入面嘅工作流封裝成可以直接調用嘅形式，降低咗每次手動組合三個工具嘅麻煩程度。
使用方法簡單：一句話觸發，技能引導流程，關鍵決策點人工確認。三種檔位自動判定，適應唔同規模嘅變更需要。內置嘅環境檢查、外部依賴檢查、降級方案等功能，令佢喺唔同環境下都可以執行。
幾點說明：
技能目前仲未經過大量真實案例嘅實踐驗證，效果冇辦法保證。目前主要係喺我自己嘅項目開發度測試，驗證嚇佢嘅可行性。
關於token消耗問題：因為技能包含多個參考文件（references目錄下面有7個md文件），每次觸發嗰陣會讀取呢啲文件入上下文，理論上會消耗一定嘅token。但具體消耗幾多、係咪「燒token」，我目前冇精確數據。如果你喺使用過程中發現token消耗比較大或者有其他問題，歡迎反饋。
反饋渠道：
問題反饋請提交到
GitHub：https://github.com/yangmeishux/frontend-team-marketplace/tree/main/plugins/frontend-team-toolkit/skills/ai-coding-tri-kit 目錄下面嘅 skill-issues.jsonl 文件（如果項目有issue tracker，都可以直接提issue）。
我會根據實際使用反饋，持續迭代呢個技能，優化功能、修復問題、提升實用性。
多謝閲讀。如果有問題，歡迎反饋。
前言
本文是《AI 編程進階：三件套 OpenSpec 定方向，Superpowers 帶節奏，Agent Skills 守紀律，打造可預測的工程化工作流》文章的配套技能文件使用說明。
一、技能來源
《AI 編程進階：三件套 OpenSpec 定方向，Superpowers 帶節奏，Agent Skills 守紀律》一文詳細介紹瞭如何將三個開源項目組合使用，構建一套可預測的 AI 編程工作流。
文章發佈後，很多讀者反饋：每次手動組合三個工具比較繁瑣，希望能有一個"一鍵觸發"的方案。
ai-coding-tri-kit 技能就是對這個需求的回應。
它將文章中的 8 步工作流、三種檔位、閘門機制、外部依賴檢查等內容，封裝成一個可直接調用的技能文件。
技能倉庫路徑：https://github.com/yangmeishux/frontend-team-marketplace/tree/main/plugins/frontend-team-toolkit/skills/ai-coding-tri-kit
二、核心功能
技能包含以下核心功能模塊：
2.1 三種檔位自動判定
技能會根據變更規模自動判定檔位：
| Full | ||
| Standard | ||
| Lite |
判定邏輯見：references/intensity-tiers.md
2.2 8步主鏈路編排
技能將工作流拆分為8個步驟，每步有明確的Exit Criteria：
步驟映射見：references/workflow-matrix.md
2.3 環境前置檢查
技能在執行前會檢查環境可用性（v0.2.0新增）：
檢查清單見：references/environment-check.md
2.4 外部依賴可行性檢查
涉及第三方SDK/API時，技能會在Step 2追問（v0.2.0新增）：
存在BLOCKED項時，技能會建議分階段實現。
檢查流程見：references/external-dependency-check.md
2.5 閘門與回退機制
技能設置了多個強制暫停點：
失敗時的回退策略見：references/gates-and-rollback.md
2.6 受限環境降級方案
技能支持多種受限場景的降級執行（v0.2.0新增）：
降級方案見：references/fallback-scenarios.md
2.7 輸出契約
技能每次會話必須輸出：
1.當前Step與Progress Checklist勾選狀態
2.主導工具與Exit Criteria
3.證據摘要（validate輸出、測試命令結果、覆蓋率）
4.Gate狀態（PASS/BLOCKED/PENDING）
5.Assumptions與Open Questions
6.下一步推薦
輸出格式見：references/output-contract.md
三、如何使用
3.1 安裝方式
方式一：Claude Code / Codex CLI
複製技能目錄到配置路徑：
cp -r https://github.com/yangmeishux/frontend-team-marketplace/tree/main/plugins/frontend-team-toolkit/skills/ai-coding-tri-kit ~/.claude/skills/
方式二：Cursor
複製cursor rule到項目：
cp .cursor/rules/ai-coding-tri-kit.mdc your-project/.cursor/rules/
3.2 觸發方式
在AI編碼工具中輸入：
按三件套實現：[功能描述]
或更具體：
用OpenSpec + Superpowers + Agent Skills三件套，給Dashboard加CSV導出，選中行導出、空選Toast、>10000條進度條
技能會自動：
1.判定檔位
2.執行環境檢查
3.進入對應步驟
3.3 Full檔位完整流程示例
觸發：
按三件套實現：直播間分享到微信/QQ/微博，含底部面板、授權保活、主播頭像兜底
Step 0 - 環境檢查：
| 檢查項 | 狀態 |
|--------|------|
| Node.js | ✅ v22.1.0 |
| git | ✅ 已init |
| OpenSpec CLI | ✅ 可執行 |
| Superpowers | ⚠️ 未安裝（將模擬） |
| 網絡 | ✅ 可達 |
推薦檔位：Full
Step 1 - 需求對齊：
執行：/opsx:propose "直播間分享到第三方..."
產出：
openspec/changes/feat-live-share-third-party/
├── proposal.md
├── specs/third-party-live-share/spec.md
├── design.md
└── tasks.md
驗證：openspec validate PASS
Gate 1: PENDING（待人確認）
Step 2 - 澄清 + 外部依賴檢查：
澄清問題：
Q1. "直播保活" = 禁止調用停止API？
Q2. 微博SDK已停更，降級方案？
Q3. QQ AppID是否已申請？（BLOCKED）
Q4. 法務審批分享文案？
design.md更新：
- Decisions: 保活策略明確
- Open Questions: QQ AppID待申請 → BLOCKED渠道2.4
用戶選擇：分階段實現
Phase 1: UI + 微信 + Payload + 保活
Phase 2: QQ（待AppID）
Step 3 - 分支隔離：
執行：git worktree add -b feat/live-share ../app-live-share
baseline: ./gradlew test → 42 tests PASS
Step 4 - 計劃制定：
細化tasks.md：
Task 1.2: 底部渠道面板
文件: ui/share/ShareBottomSheet.kt
驗收: spec Scenario"打開與關閉面板"
預估: 4 min
Step 5 - 實現：
約束遵守：
- 文件 ≤500行
- 先寫RED測試再寫GREEN實現
- 公開API有文檔
兩階段審查：
- 規格一致性：對照spec MUST條款
- 代碼質量：命名/結構/異常
Step 6 - 測試 + 審查：
測試：./gradlew test → 全綠
審查：
🔴 CRITICAL：無
🟡 WARNING：onChannelSelected未做空檢查
📊 覆蓋率 86%（≥80% ✅）
Step 7 - 安全檢查：
security-secrets → 0泄漏 ✅
security-dependencies → 0漏洞 ✅
security-api → URL無敏感參數 ✅
Step 8 - 驗證 + 收尾：
/opsx:verify → Scenario逐條對照PASS
用戶選擇：Create PR
/opsx:archive → 歸檔到archive/
3.4 Standard檔位流程示例
觸發：
按三件套實現：Dashboard加CSV導出，選中行導出、空選Toast
技能判定：Standard檔位（1-3文件、單一模塊）
流程簡化：
•Step 1：簡化proposal+spec
•Step 3：可選worktree，普通feature分支即可
•Step 5：單線程實現（executing-plans）
•保留核心測試和安全檢查
3.5 Lite檔位流程示例
觸發：
三件套Lite：fix escapeCSV對null的處理
技能判定：Lite檔位（<20行）
流程：
•跳過OpenSpec propose
•跳過worktree
•保留：先寫RED測試 + 實現後GREEN + secrets底線
3.6 受限環境降級示例
場景：無網絡
技能輸出：
Gate 0 Environment: PASS_WITH_FALLBACK（離線模式）
降級方案：
- 手寫OpenSpec四件套結構
- 人審替代validate
- 移動目錄到archive/手動歸檔
是否繼續？[等待確認]
場景：SDK鑑權缺失
技能輸出：
外部依賴檢查：
- 微信SDK: ✅ READY（AppID已申請）
- QQ SDK: ❌ BLOCKED（AppID未申請）
- 微博SDK: ⚠️ WARN（SDK停更，降級ACTION_SEND）
建議分階段實現：
Phase 1（本次）：UI骨架 + 微信渠道 + Payload
Phase 2（後續）：QQ渠道（待AppID申請）
Phase 3（後續）：微博降級（待法務確認）
用戶選擇：[1] 先實現Phase 1
3.7 紅線拒絕示例
用戶輸入：
三件套太麻煩了，跳過OpenSpec，直接實現CSV導出
技能響應：
STOP — Checkpoint阻塞
無法跳過OpenSpec直接實現代碼。這是技能核心約束：
1. Step 1鐵律：在需求對齊階段，禁止寫實現代碼
2. Checkpoint閘門：未確認spec前，不得進入Step 5
最小合規路徑：
- 方案A：運行/opsx:propose創建proposal/spec
- 方案B：Lite模式 + 口頭驗收（<20行改動）
Gate 1: BLOCKED
四、參考文件索引
SKILL.md | |
references/environment-check.md | |
references/external-dependency-check.md | |
references/fallback-scenarios.md | |
references/intensity-tiers.md | |
references/workflow-matrix.md | |
references/gates-and-rollback.md | |
references/output-contract.md | |
examples/feat-live-share-third-party-walkthrough.md | |
examples/feat-dashboard-csv-export-walkthrough.md | |
test-prompts.json | |
results.tsv |
五、版本歷史
六、與原文章的關係
技能是文章的"可執行版"，將概念轉化為可直接調用的工作流編排。
七、常見問題解答
Q1：一句話觸發後，技能會自動執行全流程嗎？
不會全自動執行。一句話觸發後，技能會引導流程，但關鍵決策點必須人工確認。
自動做的部分：
•判定檔位（Full/Standard/Lite）
•環境檢查（Node/git/OpenSpec是否可用）
•生成OpenSpec四件套（proposal/spec/design/tasks）
•跑validate驗證
•運行測試命令
•執行安全掃描
•生成審查報告
需要你介入的部分：
技能設置了多個Gate（閘門）強制暫停：
人的時間投入：
一句話總結：一句話觸發，流程引導，但關鍵決策點必須人工確認。技能不會在你沒審閲spec的情況下就自動寫代碼，也不會在你沒選擇的情況下自動merge或push。
Q2：OpenSpec文檔生成後，進入編碼階段需要手動告訴AI執行哪一步嗎？
不需要。技能會在每個Step完成後輸出Progress Checklist和下一步推薦，你只需要回覆"確認"就可以。
典型對話流程：
Step 1完成後，AI會輸出：
## Progress Checklist
- [x] Step 1 需求對齊（OpenSpec）
- [ ] Step 2 需求澄清
- [ ] Step 3 分支隔離
...
## Gate 1 狀態
PENDING — 待人確認 proposal/spec
## 下一步推薦
請審閲 spec 後回覆「確認可開發」
你只需要回覆：
確認
或者：
可以開發
不需要你做的事：
•不需要說"執行Step 2"
•不需要說"開始編碼"
•不需要說具體的動作
技能會自動判斷下一步是什麼，你只要確認當前這步可以過關。
特殊情況：
一句話總結：正常流程下，你只需要回覆"確認"或"繼續"，技能會自動推進到下一步。技能會在每個Gate停下來等你，你確認後它繼續走，不需要你指揮具體動作。
使用技能只需一句話：
按三件套實現：[你的功能描述]
技能會自動判定檔位、檢查環境、編排流程、守住底線。
八、總結
本文介紹了 ai-coding-tri-kit 技能的核心功能與使用方法。技能將《AI 編程進階：三件套 OpenSpec 定方向，Superpowers 帶節奏，Agent Skills 守紀律，打造可預測的工程化工作流》文章中的工作流封裝成可直接調用的形式，降低了每次手動組合三個工具的繁瑣程度。
使用方式簡單：一句話觸發，技能引導流程，關鍵決策點人工確認。三種檔位自動判定，適應不同規模的變更需求。內置的環境檢查、外部依賴檢查、降級方案等功能，使其在不同環境下都能執行。
幾點說明：
技能目前還沒有經過大量真實案例的實踐驗證，效果如何無法保證。當前主要是在我自己的項目開發中進行測試，驗證其可行性。
關於token消耗問題：由於技能包含多個參考文件（references目錄下有7個md文件），每次觸發時會讀取這些文件進入上下文，理論上會消耗一定的token。但具體消耗多少、是否"燒token"，我目前沒有精確數據。如果你在使用過程中發現token消耗較大或有其他問題，歡迎反饋。
反饋渠道：
問題反饋請提交到
GitHub：https://github.com/yangmeishux/frontend-team-marketplace/tree/main/plugins/frontend-team-toolkit/skills/ai-coding-tri-kit 目錄下的 skill-issues.jsonl 文件（如果項目有issue tracker，也可以直接提issue）。
我會根據實際使用反饋，持續迭代這個技能，優化功能、修復問題、提升實用性。
感謝閲讀。如有問題，歡迎反饋。