Fibo Skills
FiboCode 内蔵ターミナルで Agent CLI(Claude Code、Codex、または Skills に対応する任意の Agent CLI)を操作するとき、Fibo Skills はその Agent に FiboCode の仕様駆動ワークフローを教えます。Skills は任意であり、なくてもターミナルは動作しますが、インストールすると 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 自身の分析パイプライン(プロンプト選択、並行処理、ディスク配置、言語別プロンプト)を理解または拡張するために使います。このスキルとアプリ内の Code Analysis は、コードを理解する同じ方法への二つの入口です。
fibo-skills-reviewer — スキル自身の健診
スキルファイルの表現だけを監査します。論理矛盾、論理の抜け、不明確な参照、冗長性のずれ、漏れ出した保守メモを見つけます。「何を定めるか」ではなく「どう述べるか」だけを変え、本物のルール競合を見つけた場合は停止して判断を利用者に委ねます。
インストール:Claude Code
Claude Code は .claude/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-* スキルが一覧に表示されます。/fibo-brainstorming で呼び出すか、タスクを説明してエージェントに適切な段階を選ばせてください。
インストール:Codex とその他のエージェント
スキルファイルは YAML frontmatter を持つプレーンな Markdown なので、エージェント間で移植できます。任意の場所へ clone してください。
git clone https://github.com/Alenkz12/FiboSkills
- ネイティブのスキル機構を持つエージェント — そのエージェントのドキュメントに従い、スキルディレクトリを clone 先へ向けます。
- 指示ファイルだけを読むエージェント — 適切な段階でスキルを読むよう、その場所と目的を指示ファイル(例:
AGENTS.md)に記述します。
有効になったことを確認する
FiboCode 内蔵ターミナルで、たとえば「このリポジトリに設定オプションを追加して」といった小さな依頼をエージェントにします。スキルが有効なら、すぐコードを編集せず、まず brainstorming 段階で AC を確認し、その後 spec.md、design.md、plan.md を .fibo/docs/specs/<feature>/ 配下に残します。
最新状態に保つ
スキルは git clone 内にあるため、最新版の取得は一行で済みます。
cd .claude/skills && git pull
ヘルプ
- 完全なスキルセットは github.com/Alenkz12/FiboSkills で確認できます。
- GitHub Discussions で質問してください。
- issue tracker で問題を報告してください。