spec-to-md

touchfish-skills

Workflow-oriented skill plugins for Claude Code — 6 plugins covering DDD, Git, code review, spec conversion, implementation, and project exploration.

繁體中文 | English

Claude Code 技能插件 Marketplace，共 6 個工作流型插件。

設計原則：只保留有明確工作流的技能。純領域知識（Spring Boot、PostgreSQL、Vue.js 等）交給 Claude 本身的能力，流程方法論（TDD、brainstorming、debugging）交給 superpowers 等外部插件。

找 dev-team？ dev-team 已拆分為獨立 repo：TouchFish-DevTeam。

v1.1.0 統一架構（2026-02-26）

所有 6 個插件統一為：

• 英文 SKILL.md（60–150 行）— AI 始終載入，terse directive style
• references/ + prompts/（按需載入）— 減少 context 佔用，Glob + Read 模式
• docs/GUIDE.zh-TW.md — 中文人類使用指南

指標	v1.0.0	v1.1.0 統一架構	目前
6 個 SKILL.md 總行數	~2,895	~752（-74%）	~914（-68%）
按需載入檔案	1	13	19
中文人類指南	1	6	6

安裝

# 直接在 Claude Code 中安裝（支援整個 Repo 作為 Marketplace）
claude mcp add-plugin https://github.com/agony1997/TouchFish-Skills

Tip：建議將 git-nanny 設為 User scope（全域可用），其餘插件依專案啟用。

插件清單

插件	版本	類型	說明	人類指南
ddd-core	1.1.1	方法論	DDD 端到端交付：DDD 理論基礎 → Event Storming → SA → SD → 實作規劃	指南
git-nanny	1.2.0	操作流程	Git 全方位專家：Commit 訊息、PR 建立與審查、分支策略、版本發布與 Changelog	指南
reviewer	1.3.0	審查流程	專案規範審查與萃取：合規審查 + 從程式碼反向萃取慣例產出 .standards/ 草稿	指南
spec-to-md	1.1.1	轉換流程	規格文件轉 AI Coding 實作文件：產出技術規格、前後端實作指示	指南
md-to-code	1.2.0	實作流程	根據實作文件實作程式碼：並行 Agent Teams 開發後端與前端	指南
explorer	1.2.0	探索工具	專案探索者：Opus Leader 指揮 sub-agents 並行探索，交叉比對產出專案地圖	指南

大功能團隊協作？ 請使用 TouchFish-DevTeam（dev-team v3.0.0）。

架構概覽

需求 ──→ ddd-core ──→ spec-to-md ──→ md-to-code ──→ git-nanny
          (DDD)        (規格→文件)    (文件→程式碼)   (提交/PR)

探索 ──→ explorer ──→ PROJECT_MAP.md
          (並行探索)

審查 ──→ reviewer ──→ 合規報告 / .standards/ 草稿
          (規範審查 + 慣例萃取)

大功能 ─→ TouchFish-DevTeam ──→ PM → API 契約 → 開發 + QA 流水線 → 交付
          （獨立 repo）          https://github.com/agony1997/TouchFish-DevTeam

搭配的外部插件

插件	來源	涵蓋
superpowers	obra/superpowers-marketplace	brainstorming、TDD、debugging、code review、plan
document-skills	anthropic-agent-skills	docx、pptx、pdf、xlsx 文件處理
claude-developer-platform	anthropic-agent-skills	Claude API 開發指南

常用開發情境

以下列出常見開發情境的推薦技能組合。粗體為 touchfish-skills 技能，其餘為 superpowers 技能（需另行安裝 superpowers 插件）。

情境	推薦技能組合	流程
接手新專案	explorer	並行探索專案結構 → 產出 PROJECT_MAP.md
新功能（完整 DDD）	brainstorming → ddd-core → spec-to-md → md-to-code → git-nanny	腦力激盪 → DDD 四階段 → 產出文件 → 並行實作 → 提交/PR
新功能（大團隊）	TouchFish-DevTeam dev-team	PM 需求分析 → API 契約 → 多角色流水線開發 → QA 審查 → 交付
新功能（輕量版）	brainstorming → writing-plans → md-to-code → git-nanny	腦力激盪 → 寫計畫 → 實作 → 提交/PR
Bug 修復	systematic-debugging → test-driven-development → git-nanny	系統化定位 → TDD 修復 → 提交/PR
程式碼審查	reviewer + requesting-code-review	專案規範審查 + 審查流程
重構	brainstorming → writing-plans → test-driven-development → git-nanny	討論範圍 → 擬計畫 → TDD 重構 → 提交/PR

未安裝 superpowers？ 所有 touchfish-skills 技能皆可獨立使用，superpowers 整合點僅為可選增強。

目錄結構

touchfish-skills/
├── .claude-plugin/marketplace.json      # Marketplace 設定（v2.0.0）
├── README.md / README.en.md
├── CHANGELOG.md
├── LICENSE
├── plugins/
│   ├── ddd-core/
│   │   ├── .claude-plugin/plugin.json
│   │   ├── skills/ddd-core/
│   │   │   ├── SKILL.md                 # AI 指令（英文，始終載入）
│   │   │   └── references/              # 按需載入（理論、模板）
│   │   └── docs/GUIDE.zh-TW.md          # 中文人類指南
│   ├── git-nanny/                       # 同上結構
│   ├── reviewer/                        # 含 prompts/（萃取 sub-agent）
│   ├── spec-to-md/
│   │   ├── skills/spec-to-md/
│   │   │   ├── SKILL.md
│   │   │   ├── prompts/                 # Teammate spawn 模板（按需載入）
│   │   │   └── references/
│   │   └── docs/GUIDE.zh-TW.md
│   ├── md-to-code/                      # 同 spec-to-md 結構
│   └── explorer/                        # 含 prompts/ + references/

Attribution

本專案的 git-nanny 技能引用了以下開放標準：