project-init
Installation
SKILL.md
專案初始化技能(三層級自動偵測)
設計理念
一套技能、三個層級。這台電腦裝了什麼工具,就自動建到哪個層級——不用問使用者「你要第幾層級」。
| 層級 | 平台 | 建立的東西 | 讀取時機 |
|---|---|---|---|
| L1 本地 | 專案資料夾(建議放在你的雲端硬碟資料夾) | AGENTS.md(專案藍圖)+handoff.md(交接檔) |
每個 session 都讀 |
| L2 GitHub | 私有 repo | git 版本控制+雲端備份 | 指定才讀 |
| L3 Obsidian | 第二大腦 vault | 專案工作流程.md(詳細筆記) |
有需要才讀 |
為什麼藍圖叫
AGENTS.md而不是CLAUDE.md?因為 AGENTS.md 是跨 Agent 開放標準——OpenCode、Claude Code、Codex、Gemini CLI 都讀得懂。專案層的檔案刻意用開放格式,任何 Agent 接手都能無縫工作。 檔名必須全大寫AGENTS.md:Windows 不分大小寫所以寫錯也能動,但 Mac/Linux 分大小寫,小寫的agents.md會變成「檔案明明在、Agent 卻讀不到」。
層級偵測(初始化看「這台電腦」有什麼)
依序檢查,決定本次能建到第幾層級: