Asgard Skills

開源的 301 個 coding agent skills 知識庫，分成 22 個主題類別。每個 skill 都是獨立的 Markdown 檔案（SKILL.md），遵循 Claude Agent Skills 規範，部分附帶純 Python 腳本做確定性計算。

English

概觀

本 repo 是 Asgard AI Platform 的原料庫。Skills 會與 Asgard MCPs 組合，打包成針對特定使用者情境的 coding agent plugins（例如台股分析師、電商營運、政策研究者）。

每個 skill 封裝的是某個明確任務的方法論 + 判斷 + 陷阱——那些 LLM agent 若沒有提示就會重新摸索、或直接做錯的東西。

Repo 結構

.
├── {category}-{skill-name}/
│   ├── SKILL.md           ← Level 1 frontmatter + Level 2 指引
│   ├── examples/          ← （必存在，視需要填充）
│   ├── references/        ← （冗長內容外掛於此）
│   └── scripts/           ← （僅在有確定性計算腳本時出現）
└── ...

類別（22 個前綴，301 個 skills）

Skill 目錄

以下列出全部 301 個 skills，依前綴分組。點擊名稱開啟其 SKILL.md。簡介為各 skill frontmatter description 的中文摘要（WHAT + WHEN）。

Skill 結構

每份 SKILL.md 遵循一致的模板：

---
name: "{category}-{skill-name}"
description: "[祈使句 WHAT + WHEN，< 1024 字元，不可含 XML 角括號]"
metadata:
  category: "WP-XX Topic Label"
  tags: [...]
---

# {Skill 顯示名稱}

## Overview / Framework
## When to Use (and When NOT to Use)
## Methodology（Phase-Gate 或 Hub-and-Spoke 模式）
## IRON LAW：{非顯而易見的約束}
## Output Format
## Gotchas
## Scripts（若適用）
## References

確定性計算腳本

目前有 20 個 skills 附帶 Python 腳本（純 stdlib、無外部依賴），處理那些 LLM 常算錯的計算：

• 財務：biz-cac-ltv、biz-breakeven、biz-dcf、biz-dupont、biz-financial-ratios、biz-unit-economics、grad-capm、fin-modeling
• 風險 / 統計：algo-risk-altman-z、algo-risk-var、mkt-ab-testing、algo-mfg-cpk
• 供應鏈：algo-sc-eoq、algo-sc-safety-stock、algo-sc-newsvendor
• 排名：algo-rank-wilson、algo-rank-elo、algo-rank-bayesian
• 電商：ecom-rfm-analysis、algo-price-elasticity
• 搜尋：algo-seo-tfidf、algo-ecom-bm25

每個腳本都支援 --help、--input 、--verify（內建自我測試）。輸出以 JSON 印到 stdout，方便後續串接。

# 範例
python ecom-rfm-analysis/scripts/rfm_score.py --input customers.json
python biz-cac-ltv/scripts/cac_ltv.py --marketing-cost 100000 --new-customers 500 \
  --arpu 50 --gross-margin 0.70 --monthly-churn 0.05

設計原則

1. Iron Law：每個 skill 都定義一條非顯而易見的約束，agent 不提示就會踩雷
2. Hub-and-Spoke：SKILL.md 精簡（< 200 行）；冗長內容外掛到 references/
3. Phase-Gate（演算法）：明確步驟、步驟之間設驗證關卡
4. 具體驗證：範例必須可精確計算，不接受「大概落在某範圍」
5. 不過度教學：假設 agent 已懂基礎，只強調它會做錯的地方

完整設計規則與品質標準見 AGENTS.md。

狀態

相關 Repo

• asgard-ai-platform/skill-template — 建立 coding agent plugin 的樣板
• asgard-ai-platform/mcp-* — MCP servers（資料原料）
• Plugin bundles（即將推出） — 針對特定情境的 skills + MCPs 組合

Domain 導航

特定領域的 skill 組織索引放在 docs/domains/：

• tw-ecommerce.md — 台灣電商（平台、金流、物流、發票、法遵、營運、分析）

貢獻指南

請見 CONTRIBUTING.md。提交新 skill 前務必先讀 AGENTS.md 了解目錄與品質標準。

授權

MIT License。見 LICENSE。