Fibo Skills
當你在 FiboCode 內建終端機中操作 Agent CLI（Claude Code、Codex 或任何支援 Skills 的 Agent CLI）時，Fibo Skills 會教導該 Agent 使用 FiboCode 的規格驅動工作流程。它們是選用功能——沒有它們終端機仍可運作——但安裝後，Agent 會取得 FiboCode 所遵循的 brainstorm → spec → plan → execute → sync 流程，讓輸出落在 .fibo/ 文件系統中，而不是與程式碼庫逐漸脫節。
Skills 是代理依需要載入的封裝指令。Fibo Skills 是開放原始碼，安裝在你的代理中，而不是 FiboCode 中。
Skills 儲存庫： github.com/Alenkz12/FiboSkills
技能組
這是一套完整工作流程，不是一堆互不相關的命令。前五個技能會在各階段間交接，最後兩個則可獨立使用：
| Skill | 階段 | 用途 |
|---|---|---|
fibo-brainstorming | 釐清需求 | 將模糊意圖轉成已簽署的 AC 清單 |
fibo-writing-plan | 決定做法 | 根據 spec 產生 design.md 與 plan.md |
fibo-executing-plan | 撰寫程式碼 | 依序逐項執行 plan 的任務 |
fibo-recording-diff | 留下紀錄 | 將真實 diff 轉成可讀、逐 hunk 的 diff.md |
fibo-conventions | 守住規則 | 統一命名、註解、文件與 commit sync 的規則集 |
fibo-code-analysis | 閱讀程式碼 | 產生分層的 file → structure → folder 分析鏡像 |
fibo-skills-reviewer | 自我維護 | 稽核技能檔案本身的措辭 |
fibo-brainstorming——先釐清需求
在改變任何外部可見行為前叫用。它一次詢問一個問題（可行時提供選項），把「我想要一項功能」逐步收斂成 EARS 語法的驗收準則，並只在你明確簽署後寫入 spec.md。它不寫正式程式碼、不執行測試，也不提交；唯一工作是消除歧義。
fibo-writing-plan——把 spec 轉為設計與任務
在 spec 簽署後叫用。它讀取 spec.md，並在同一目錄產生 design.md（HOW，每項設計決策皆標示 ↔ AC）及 plan.md（每項任務列出 AC、檔案與驗證方式）。如果 AC 覆蓋率低於 100%，或任務引用不存在的 AC，它會拒絕寫入磁碟。
fibo-executing-plan——嚴格依序執行 plan
逐項且不並行地執行 plan.md 任務，避免平行任務在相同檔案上衝突。每項任務只能修改自身清單中的檔案。失敗時會停止並詢問你要跳過 / 中止 / 重試，而不會自行回復。全部完成後會輸出實作報告，並直接進入 diff 紀錄與文件同步。
fibo-recording-diff——讓變更容易閱讀
在實作後叫用。它將真實 diff 轉成 hunk 級說明，以連貫順序排列變更檔案，為每個 hunk 附加程式碼錨點與必要的 Mermaid 邏輯檢視，並解釋每個 hunk 存在的原因及與周邊邏輯的連結。它不修改程式碼或 AC。
fibo-conventions——讓文件與註解保持同一種聲音
撰寫 Markdown、新增程式碼註解或在 .fibo/docs/ 下建立內容時適用：涵蓋 Mermaid 使用方式、code / text / graph 標籤格式、路徑規則、命名規則、註解與程式碼同步，以及利用 .fibo/index.json 追蹤基準的提交前批次文件同步。
fibo-code-analysis——結構化分析輸出
用來產生 .fibo/analysis 下的結構化分析，也用來理解或擴充 FiboCode 自身的分析管線：prompt 選擇、並行處理、磁碟配置與各語言 prompt。它與應用程式內的 Code Analysis，是進入同一套程式碼理解方式的兩個入口。
fibo-skills-reviewer——技能本身的健康檢查
只稽核技能檔案的措辭：邏輯矛盾、邏輯缺口、不清楚的引用、重複內容漂移與洩漏的維護旁註。它只改變「如何表達」，不改變「規則是什麼」；若發現真正的規則衝突，會停止並把決定交給你。
安裝：Claude Code
Claude Code 從 .claude/skills/ 目錄讀取 skills。專案層級只對單一程式碼庫生效；使用者層級則在所有地方都可使用：
# Project level (recommended: travels with the repo, so team and agent share one rule set)
git clone https://github.com/Alenkz12/FiboSkills .claude/skills
# Or user level (available in every project)
git clone https://github.com/Alenkz12/FiboSkills ~/.claude/skills
重新啟動 Claude Code（或開始新工作階段）後，fibo-* skills 便會出現在清單中。使用 /fibo-brainstorming 叫用，或直接描述任務，讓代理選擇適合的階段。
安裝：Codex 與其他代理
skill 檔案是帶有 YAML frontmatter 的純 Markdown，因此可在不同代理間移植。將它們 clone 到任何適合的位置：
git clone https://github.com/Alenkz12/FiboSkills
- 具有原生 skills 機制的代理——依該代理的文件，將 skills 目錄指向 clone 的位置。
- 只讀取指令檔的代理——在該檔案（例如
AGENTS.md）中描述這些 skills 的位置與用途，讓代理在正確階段讀取它們。
確認是否生效
在 FiboCode 內建終端機中交給代理一個小任務，例如「替這個儲存庫新增一個設定選項」。skills 生效時，它不會先編輯程式碼，而會開啟 brainstorming 階段與你確認 AC，之後留下 spec.md、design.md 與 plan.md，存放在 .fibo/docs/specs/<feature>/ 下。
保持最新
因為 skills 位於 git clone 中，拉取最新版只需一行：
cd .claude/skills && git pull
取得協助
- 在 github.com/Alenkz12/FiboSkills 瀏覽完整技能組。
- 到 GitHub Discussions 提問。
- 到 issue tracker 回報問題。