Context

查閱官方文件後發現 .claude/commands/.claude/skills/<name>/SKILL.md 雖然底層相同,但 skills 格式有幾個值得遷移的具體功能。

Key Insights

  • commands/skills/ 機制相同,但 skills 有 frontmatter:官方文件明確說「Custom commands have been merged into skills」,.claude/commands/deploy.md.claude/skills/deploy/SKILL.md 效果一樣。現有 commands 繼續有效,但 skills 支援額外功能。

  • disable-model-invocation: true 是最重要的新功能:vault 的指令幾乎都有副作用(寫檔、commit、推送),應全部設為只允許用戶手動呼叫,防止 Claude 自動觸發。這個功能在 commands 格式裡不存在。

  • context: fork 讓長任務跑在 subagentarxiv-digestresearch-vault 這類長時間任務加了 context: fork 後在獨立 context 執行,不占用主 context window。

  • Supporting files 讓 skill 目錄化:每個 skill 可附帶 templates、examples、scripts,vault-codemap 可以從 inline 引用改為放在 skill 目錄內直接 reference,結構更清晰。

  • 動態 context injection(!`command`:skill 執行前先跑 shell 指令並注入輸出,比在指令文字裡說「先執行 XXX 指令」更可靠。

Connections