.claude/skills/dev-workflow-guide/SKILL.md
[UDS] 將軟體開發階段對應到 UDS 指令與功能的指南
npx skillsauth add asiaostrich/universal-dev-standards dev-workflowInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
語言: English | 繁體中文
將你目前的軟體開發階段對應到正確的 UDS 指令與技能。即時了解在開發的每個階段應該使用哪些工具。
相關:如需選擇或切換開發方法論(SDD、BDD、TDD),請改用
/methodology。
I. 規劃設計 ──► II. 測試驅動開發 ──► III. 程式碼開發 ──► IV. 品質保證
V. 版本提交 ──► VI. 文件與架構 ──► VII. 工具與標準 ──► VIII. 進階分析
| 階段 | UDS 指令 | 用途 |
|------|----------|------|
| I. 規劃與設計 | /brainstorm /requirement /sdd /reverse | 需求、規格、逆向工程 |
| II. 測試驅動開發 | /bdd /atdd /tdd /coverage /derive | 先寫測試再寫程式 |
| III. 實作 | /refactor /reverse | 撰寫與改善程式碼 |
| IV. 品質關卡 | /checkin /review | 提交前檢查與程式碼審查 |
| V. 發布與提交 | /commit /changelog /release | 版本、提交、發布 |
| VI. 文件 | /docs /docgen /struct | 文件與專案結構 |
| VII. 工具與標準 | /discover /testing /guide /git | 參考指南 |
| VIII. 進階分析 | /methodology | 跨方法論工作流程 |
從零開始建立新功能的推薦流程:
/brainstorm → /requirement → /sdd → /derive → /tdd → /checkin → /commit
| 步驟 | 指令 | 做什麼 |
|------|------|--------|
| 1 | /brainstorm | 探索想法與方法 |
| 2 | /requirement | 撰寫使用者故事(INVEST 準則) |
| 3 | /sdd | 建立規格文件 |
| 4 | /derive | 從規格產生測試骨架 |
| 5 | /tdd | 用紅綠重構循環實作 |
| 6 | /checkin | 驗證品質關卡 |
| 7 | /commit | 建立規範化提交 |
修復既有程式碼錯誤的推薦流程:
/discover → /reverse → /tdd → /checkin → /commit
| 步驟 | 指令 | 做什麼 |
|------|------|--------|
| 1 | /discover | 評估受影響區域健康度 |
| 2 | /reverse | 理解現有程式碼結構 |
| 3 | /tdd | 先寫失敗測試,再修復 |
| 4 | /checkin | 驗證品質關卡 |
| 5 | /commit | 建立規範化提交 |
程式碼重構的推薦流程:
/discover → /reverse → /coverage → /refactor → /checkin → /commit
| 步驟 | 指令 | 做什麼 |
|------|------|--------|
| 1 | /discover | 評估專案健康度與風險 |
| 2 | /reverse | 記錄目前行為 |
| 3 | /coverage | 確保測試安全網存在 |
| 4 | /refactor | 套用重構策略 |
| 5 | /checkin | 驗證品質關卡 |
| 6 | /commit | 建立規範化提交 |
/dev-workflow # 顯示完整階段總覽
/dev-workflow planning # 取得第 I 階段指引
/dev-workflow testing # 取得第 II 階段指引
/dev-workflow new-feature # 取得新功能工作流程
/dev-workflow bug-fix # 取得修復錯誤工作流程
/dev-workflow refactoring # 取得重構工作流程
| 參數 | 說明 |
|------|------|
| planning | 第 I 階段:規劃與設計 |
| testing | 第 II 階段:測試驅動開發 |
| implementation | 第 III 階段:程式碼開發 |
| quality | 第 IV 階段:品質保證 |
| release | 第 V 階段:版本與提交 |
| docs | 第 VI 階段:文件與架構 |
| standards | 第 VII 階段:工具與標準 |
| advanced | 第 VIII 階段:進階系統分析 |
| new-feature | 場景:新功能開發 |
| bug-fix | 場景:修復錯誤 |
| refactoring | 場景:重構 |
呼叫時:
/dev-workflow 完成後,AI 助手應根據使用者情況建議:
工作流程已顯示。建議下一步:
- 新功能開發 → 執行
/brainstorm探索想法- 修復錯誤 → 執行
/discover評估受影響區域- 重構程式碼 → 執行
/discover評估健康度- 遺留系統 → 執行
/reverse進行系統考古
development
[UDS] 扫描代码库的调试残留与代码质量问题;可自动修正安全模式。 Use when: before committing, during PR review, or periodic codebase cleanup. Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 扫描, 清理.
tools
[UDS] 从规格衍生 BDD 场景、TDD 骨架或 ATDD 表格
development
[UDS] 识别重复流程并以正确的开发深度构建 Skill
tools
[UDS] AI 辅助 git push 安全层:质量门禁 + 协作护栏。 Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches. Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.