Skill Commons

skill-commons

[](https://github.com/Chuliying/skill-commons/actions/workflows/ci.yml)

skill-commons 是 AI 協作開發的 repository-native workflow kit。它把需求、Spec、Plan、實作狀態、驗證證據與交付授權留在 Git，讓開發者、Claude Code、Codex 與 Cursor 從同一份最新工作狀態接手。[English summary](README.en.md) · [互動 Repo Map](https://skill-commons-map.vercel.app) · [Quick Start](#quick-start) · [References](#references)

專案範疇

產品是一份可驗證、可接續的共享工程狀態：Spec 是施工圖，Plan 是施工順序，`meta.yml` 是進度板，測試與 review 是驗收證據，Git 保存變更歷史。適合跨 session、agent、工具、開發者或正式 review gate 的工作；事實查證與 bounded micro-task 由 Router 走最短路徑，避免額外文件。Spec drift 與交接邊界的完整模型見 [Spec-state protocol](docs/spec-state-protocol.md)。

上游生態（[Agent Skills](https://agentskills.io/specification)、[Superpowers](https://github.com/obra/superpowers)）解決可攜技能與開發方法；本專案在其上補足共享契約——repository artifact、Plan、evidence 與 delivery contract。外部來源、pinned commit 與本地 patch 見 [SOURCES.md](SOURCES.md)。

專案能力

能力	一句話	怎麼做到
任務路由	Router 依單一任務選最小 execution mode 與 artifact 集合，清楚的小修改走直接路徑	skill-router
持久交接	dependencies、blockers、DoD 與 evidence 存活於 docs/work//，第二個 session 從 repository 狀態接手	plan-sync · Spec-state protocol
狀態入口	project-status 唯讀、deterministic、no-LLM，回報狀態、attention 與下一步	ARTIFACTS.md
跨 repo 偵測	任務依賴本 repo 之外的工作時偵測並停下確認，participant 記錄於 Plan，evidence 留在原 repo	Cross-repo contract
跨工具安裝	top-level skills 單一來源，onboarding 產生各平台 adapters；skill fan-out 僅及 Claude Code 與 Codex，Cursor 走 rule + AGENTS adapter；consuming repo 以 submodule pin 版本	Bootstrap · Platform support
交付授權	工作完成與對外交付分開記錄；push、merge、discard、destructive recovery 與 publication 前需明確授權	ARTIFACTS.md · sync-work

`delivery_mode` 是安裝時選擇的技能組合（`personal`、`team-sprint`，外加