Dev Diagnosis.skill

開發需求分診與治理引導工具。

在動手之前，先辨識價值。

---

為什麼做這個

高效率生產垃圾還是垃圾。

每次有人說「我想做一個⋯⋯」，最危險的反應是立刻開始做。該問的問題沒問，該查的東西沒查，做完才發現早就有人做過、根本不需要自動化、或者用錯了工具。

Dev Diagnosis 是一個結構化的分診流程——從模糊的需求出發，經過診斷，判斷該用什麼方式開發、如何管理。它不幫你寫 code，它幫你決定要不要寫、怎麼寫、寫完放哪裡。

四個階段：診斷 → 選解法 → 分級管理 → 落地。每個階段結束時確認，再進下一步。

工作站（Workstation）

工作站是你的工作環境——一個組織、一個團隊、或一個專案。

想像你拿到一台新的工作電腦：你會裝特定的 app、設定 API key、登入需要的帳號、把使用習慣調好。這一整套「為了在某個環境做事而做的配置」，就是一個工作站。每個工作站有自己的技術棧、資安限制、開發規範和既有工具清單。

分診流程會根據你所在的工作站，套用對應的規則來判斷。同樣一個需求，在資安要求嚴格的組織可能走受管開發，在個人專案裡可能是自由開發。

用 _template.md 為你的工作站建立設定檔，放在 workstations/ 目錄下。

在哪裡使用

這個 skill 可以在 Claude.ai 或 Claude Code 中使用，但能做的事不同：

簡單說：Claude.ai 能「診斷」，Claude Code 能「診斷 + 落地」。

安裝

Claude Code

將 skill 安裝到你的 git repo 的 .claude/skills/ 目錄下：

# Project-level（僅限該專案使用）
mkdir -p .claude/skills
git clone https://github.com/mseatingtpe/dev-diagnosis-skill .claude/skills/dev-diagnosis

# Global（所有專案皆可使用）
git clone https://github.com/mseatingtpe/dev-diagnosis-skill ~/.claude/skills/dev-diagnosis

安裝後，當你描述開發需求時會自動觸發，也可以手動呼叫 /dev-diagnosis。

Claude.ai

將 SKILL.md 的內容貼入 Project instructions 或對話中即可使用（僅支援診斷，不支援落地操作）。

檔案

dev-diagnosis-skill/
├── SKILL.md              # 完整的分診引導邏輯
├── _template.md          # 工作站設定檔模板
├── workstations/         # 各工作站的設定檔
└── references/           # 補充說明（按需讀取）
    ├── ai-tool-vs-agent.md
    └── health-check.md

分診報告格式

四個階段走完後，產出一份結構化的分診報告：

# 開發需求分診報告

## 診斷
- 問題：[摘要]
- 既有資源：[直接用 / 可改造 / 可串接（列出哪些 + 缺口）/ 重建]
- 延展性：[高 / 中 / 低]

## 解法
- 建議層級：[人工 / 自動化 / AI 工具 / Agent]
- 理由：[說明]

## 管理
- 分級：[受管開發 / 輕量管理 / 自由開發]
- 具體行動：[依工作站設定檔列出]

## 落地
- 產出形式：[Skill / 腳本 / Prompt template / 其他]
- 存放位置：[路徑]
- 既有 skill 清單登記：[是 / 待登記]
- 下一步：[具體行動]

決策流程圖