Skip to content

stanley-1028/agent-skill-matrix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

55 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 Agent Skill Matrix — 你的 AI 數位員工訓練手冊

Release Test & Publish 165 tests

AI 不是老虎機,是數位員工。
要讓 AI 做出高品質的東西,得教 AI 怎麼做。
── 我的師父 Dan Koe


🎯 這是什麼?

這是一套11 個專業技能的訓練手冊,讓 AI 從「亂猜的老虎機」變成「受過訓練、會思考、有底線的數位員工」。

每個技能教會 AI 三件事:

層次 做什麼 就像
🧠 思考框架 知道怎麼想——定義問題、質疑自己、面對不確定 達文西的繪畫思維
⛓️ 制約系統 知道什麼不能做——安全、誠實、負責的底線 員工手冊的紅線
🛠️ 方法工具 知道怎麼做——具體步驟、實戰範例、品質檢查 SOP 與檢查清單

這不是一個「只會照 SOP 做事」的工具。
這是一個受過完整訓練,能在你沒說的時候自己判斷對錯的數位員工


📦 11 個專業技能

技能 角色 層級 核心能力
🔍 skilled-researcher 情報員 情報層 深度檢索、來源驗證、知識合成
📊 skilled-analyst 分析師 數據層 數據洞察、統計檢定、根因分析
📋 skilled-strategist 策略長 策略層 需求驗證、優先級排序、路線圖規劃
🏗️ skilled-architect 架構師 設計層 系統設計、技術選型、ADR 決策記錄
🛠️ skilled-engineer 工程師 執行層 程式架構、安全加固、自動化管線
🎨 skilled-designer 設計師 執行層 UI/UX 佈局、設計系統、無障礙規範
🧪 skilled-tester 測試員 執行層 品質保證、滲透測試、邊界驗證
📋 skilled-planner 專案經理 管理層 任務分解、風險評估、Sprint 規劃
🚀 skilled-operator 維運工程師 營運層 平台可靠度、事故響應、容量規劃
⚙️ skilled-devops DevOps 運維層 CI/CD、IaC、容器化、監控告警
📢 skilled-communicator 溝通專家 表達層 文件撰寫、受眾適應、簡報技巧

🧠 每個技能的靈魂

以前的 AI 技能只有「步驟」:做 A、做 B、做 C。
現在每個技能多了兩層:

思考框架

1. 定義問題    →  在做之前先想清楚真實需求
2. 質疑自己    →  識別假設和盲點,避免認知偏誤
3. 面對不確定  →  資訊不足時該怎麼做決定
4. 檢查盲點    →  我忽略了什麼?哪裡可能出錯?
5. 自我評估    →  這個產出真的有用嗎?還是黃金垃圾?

制約系統(不可違背)

🔴 5 條全球鐵律       →  不偽造、不隱藏、不給虛假確定性...
🟡 4 條高危行為       →  需要特別授權才能執行
🔴 44 條領域制約      →  每個技能 4 條專屬禁止規則

會思考但沒制約的員工,比不會思考的更危險。
思考 + 制約 = 真正可靠的數位員工。

最終品質閘門(零缺陷原則)

🔎 系統性缺陷狩獵     →  主動審查所有邊界、異常路徑、資源洩漏
🔬 根本原因分析       →  問三次「為什麼」直到找到源頭
✅ 修復驗證           →  每個修復必須有可重現的驗證方式
🛡️ 回歸防護           →  已修缺陷轉化為自動化檢查,永不復發
🔄 零缺陷迭代         →  直到沒有已知缺陷才能交付

交付不是「做好了」,而是「沒有已知的缺陷了」。
思考 + 制約 + 零缺陷 = 可靠到可以放心的數位員工。


🚀 快速安裝

💻 Cursor

python install.py --platform cursor

🤖 AstrBot

python install.py --platform astrbot
#
scripts\install-astrbot.bat  # Windows

🌸 Hanako

python install.py --platform hanako

💬 OpenAI Codex CLI / 🟣 Claude

python install.py --platform openai
python install.py --platform claude

📝 任何平台

python install.py --platform manual --path ./my_skills

🌐 全部一次搞定

python install.py --platform all

安裝後記得重啟平台讓新技能生效。


🧩 自訂技能 (Custom Skills)

本專案支援使用者自訂技能,讓你在升級官方技能時,不會遺失自己的本地修改!

使用方式:

  1. 在專案根目錄下建立 custom_skills/ 資料夾:
    mkdir custom_skills
  2. custom_skills/ 下建立你的自訂技能資料夾(如 my-custom-skill),並在其中撰寫 SKILL.md
    custom_skills/
    └── my-custom-skill/
        ├── SKILL.md          # 必須包含 YAML front-matter
        ├── tools/            # 可選:自訂工具
        └── templates/        # 可選:自訂模板
    
  3. 執行安裝命令:
    python install.py --platform cursor
    安裝器會自動掃描並合併官方技能與你的自訂技能,一併安裝到目標平台!

🧭 平台相容性

平台 支援方式 難度
Cursor ~/.agents/skills/ 目錄
AstrBot data/skills/ 目錄
Hanako install_skill 命令
OpenAI Codex CLI 原生 SKILL.md
Anthropic Claude 原生 SKILL.md
ChatGPT 手動複製 system prompt ⭐⭐
任何平台 JSON/system prompt 注入 ⭐⭐

🧪 驗證&測試

# 執行全部 165 項測試
python -m pytest tests/ -v

# 一站式健康檢查
python shared-tools/health-check.py

# 技能元數據驗證
python v3/validate.py

# 全平台同步(開發用)
python sync-all.py

📋 版本歷史

版本 變更
v4.4.0 🧹 移除自動更新與同步系統 — 移除過度設計、不穩定且多餘的背景自動更新與同步機制,回歸標準 Git 版本控制與手動更新,大幅簡化程式碼並提升安全性
v4.3.0 🔎 零缺陷品質閘門 — 11 技能新增最終品質閘門:系統性缺陷狩獵、根本原因分析、修復驗證、回歸防護、零缺陷迭代。版本同步更新至 v1.2.0
v4.2.0 🔄 全自動更新系統 — auto-updater.py 排程修復、跨時區 UTC 支援、Linux 相容 (已於 v4.4.0 移除)
v4.1.0 ⛓️ 制約系統 — 11 技能新增不可違背的鐵律(全球 5 條 + 領域 44 條)
v4.0.0 🧠 思考框架 — 從 SOP 升級為思考框架,教 AI 怎麼定義問題、質疑自己
v3.5.0 🔧 11 技能內容深化(使用範例、邊界情況、品質檢查)
v3.4.4 🔄 全自動同步系統(每天 09:00 + 18:00 自動同步)
v3.4.1 🐛 修復安裝器遺漏工具與模板
v3.3.x 安裝器最佳化、路徑修復
v3.2 🧩 八角色擴展(新增 Strategist、Operator、Analyst)
v3.1 🎯 跨平台支援:通用安裝器 + 6 平台指南
v3.0 動態路由 + 形式化驗證

🙏 致謝

這個專案的誕生源自一位關鍵人物——Dan Koe

他教了我兩件事:

  1. 明確地向 AI 說出你想要什麼
  2. 要讓 AI 產出高品質的東西,得教 AI 怎麼做

從那時候起,AI 不再是一個黑盒子老虎機——它是聽我指揮的數位員工

「如果人或 AI 不會思考,那怎麼會做出好東西呢?」


🤝 貢獻

歡迎貢獻!請先閱讀 CONTRIBUTING.md

快速入門:

  1. Fork 本倉庫
  2. 修改或新增 skilled-*/SKILL.md
  3. 確保遵守思考框架與制約
  4. 執行 python -m pytest tests/ -v 確認測試通過
  5. 提交 PR

📄 License

MIT — 自由使用、修改、分發。但請記得 Dan Koe 的教導:不要讓 AI 變回老虎機。

About

11 AI Professional Skills in Anthropic SKILL.md format. Train your AI with thinking frameworks, constraint systems & zero-defect quality gates. Works with Claude Code, Claude.ai & OpenAI Codex CLI. Free & open source.

Topics

Resources

License

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors