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 卻讀不到」。

層級偵測(初始化看「這台電腦」有什麼)

依序檢查,決定本次能建到第幾層級:

Installs
1
GitHub Stars
28
First Seen
Oct 2, 2026