From 89fcdeab0ee3287d1ddc424d7c5be1fe46885933 Mon Sep 17 00:00:00 2001 From: Jiro Date: Sun, 26 Jul 2026 13:03:22 +0900 Subject: [PATCH 1/3] =?UTF-8?q?role=20skill=20=E3=81=A8=20agent=20?= =?UTF-8?q?=E3=82=92=E5=88=86=E9=9B=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit role skill を agent への委譲入口と playbook に分離する。worker agent と role-worker を追加し、モデル設定とブランチ運用の指示も更新する。 --- AGENTS.md | 4 + claude/CLAUDE.md | 8 + claude/agents/advisor.md | 5 +- claude/agents/documenter.md | 2 +- claude/agents/implemnter.md | 6 +- claude/agents/planner.md | 5 +- claude/agents/reviewer.md | 5 +- claude/agents/scouter.md | 6 +- claude/agents/worker.md | 8 + codex/AGENTS.md | 8 + codex/agents/advisor.toml | 4 +- codex/agents/implementer.toml | 4 +- codex/agents/planner.toml | 4 +- codex/agents/reviewer.toml | 4 +- codex/agents/scount.toml | 4 +- codex/agents/worker.toml | 7 + codex/config.toml | 2 +- .../internal/role-advisor-playbook/SKILL.md | 104 ++++++++++++ .../evals/evals.json | 4 +- codex/skills/internal/role-advisor/SKILL.md | 102 +---------- .../role-implementer-playbook/SKILL.md | 123 ++++++++++++++ .../evals/evals.json | 4 +- .../skills/internal/role-implementer/SKILL.md | 121 +------------- .../internal/role-planner-playbook/SKILL.md | 158 ++++++++++++++++++ .../evals/evals.json | 4 +- codex/skills/internal/role-planner/SKILL.md | 156 +---------------- .../internal/role-reviewer-playbook/SKILL.md | 116 +++++++++++++ .../evals/evals.json | 6 +- codex/skills/internal/role-reviewer/SKILL.md | 114 +------------ .../internal/role-scouter-playbook/SKILL.md | 60 +++++++ .../evals/evals.json | 4 +- codex/skills/internal/role-scouter/SKILL.md | 58 +------ .../internal/role-worker-playbook/SKILL.md | 10 ++ .../role-worker-playbook/evals/evals.json | 12 ++ codex/skills/internal/role-worker/SKILL.md | 6 + docs/skill-dependency-map.md | 12 +- docs/skill-library.md | 17 +- 37 files changed, 690 insertions(+), 587 deletions(-) create mode 100644 claude/agents/worker.md create mode 100644 codex/agents/worker.toml create mode 100644 codex/skills/internal/role-advisor-playbook/SKILL.md rename codex/skills/internal/{role-advisor => role-advisor-playbook}/evals/evals.json (75%) create mode 100644 codex/skills/internal/role-implementer-playbook/SKILL.md rename codex/skills/internal/{role-implementer => role-implementer-playbook}/evals/evals.json (70%) create mode 100644 codex/skills/internal/role-planner-playbook/SKILL.md rename codex/skills/internal/{role-planner => role-planner-playbook}/evals/evals.json (72%) create mode 100644 codex/skills/internal/role-reviewer-playbook/SKILL.md rename codex/skills/internal/{role-reviewer => role-reviewer-playbook}/evals/evals.json (59%) create mode 100644 codex/skills/internal/role-scouter-playbook/SKILL.md rename codex/skills/internal/{role-scouter => role-scouter-playbook}/evals/evals.json (74%) create mode 100644 codex/skills/internal/role-worker-playbook/SKILL.md create mode 100644 codex/skills/internal/role-worker-playbook/evals/evals.json create mode 100644 codex/skills/internal/role-worker/SKILL.md diff --git a/AGENTS.md b/AGENTS.md index d3e9eef..1cdc36e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -56,6 +56,10 @@ Codex / Claude 向けの agent、skill、設定、プロンプトを管理し、 - `make deploy` で Codex / Claude 用の設定、agent、skill、prompt、rule を配布します。 - `make apply` は `make deploy` の別名です。 +## ブランチ運用 + +- 作業ブランチをデフォルトブランチの最新状態へ追従させるときは、merge ではなく rebase を使用します。 + ## 配布時の確認 通常は、次の順で実行します。 diff --git a/claude/CLAUDE.md b/claude/CLAUDE.md index 85eb694..5dcb885 100644 --- a/claude/CLAUDE.md +++ b/claude/CLAUDE.md @@ -25,10 +25,18 @@ KPI やカバレッジ目標が与えられたら、達成するまで試行す - コード生成・修正のタスクは Sonnet モデル - 機械的な作業は Haiku モデルを使用する +## 完了報告 + +- 作業完了時の最終報告には、使用した AI モデルのバージョンを明記します。 + ## 推奨コマンド - file 検索やfile 内文字列検索には ripgrep を使う。例: `rg --files` や `rg ` +## ブランチ運用 + +- 作業ブランチをデフォルトブランチの最新状態へ追従させるときは、merge ではなく rebase を使用します。 + ## コマンド実行確認 - prompt なしで実行できるのは、許可済みルールに合致し、実行内容と影響範囲が明確なコマンドだけです。 - 破壊的操作、外部送信、認証情報や設定の変更、履歴改変、実行先が曖昧なコマンドは、実行前にユーザーへ確認します。 diff --git a/claude/agents/advisor.md b/claude/agents/advisor.md index 2b52b29..d0a272c 100644 --- a/claude/agents/advisor.md +++ b/claude/agents/advisor.md @@ -1,7 +1,8 @@ --- name: advisor -description: ソフトウェアエンジニアリング、アーキテクチャ、データベース設計、バックエンド開発、DevOps、CI/CD、テスト、セキュリティ基礎、保守性、チーム開発について、役割に応じた実践的な助言と一般的なベストプラクティスを提供する。ベストプラクティスの推奨、トレードオフ分析、設計レビュー、技術判断の相談、実装を伴わない実務的なテックリード視点の意見が必要なときに使う。 +description: 技術的な助言を担当するエージェントです。 +model: opus tools: Read, Grep, Glob, Bash --- -`role-advisor` skill を利用してください。 +`role-advisor-playbook` をもとに作業を進めてください。 diff --git a/claude/agents/documenter.md b/claude/agents/documenter.md index ddf17c5..6f0d866 100644 --- a/claude/agents/documenter.md +++ b/claude/agents/documenter.md @@ -1,8 +1,8 @@ --- name: documenter description: ドキュメント作成エージェントの役割を定義します。Doc エージェントは、プロジェクトの技術文書やガイドラインの作成・整備を担当し、情報の一貫性と明確さを確保します。 +model: sonnet tools: Read, Grep, Glob, Bash --- role-doc スキルを利用してください。 - diff --git a/claude/agents/implemnter.md b/claude/agents/implemnter.md index 5b40821..3592d67 100644 --- a/claude/agents/implemnter.md +++ b/claude/agents/implemnter.md @@ -1,8 +1,8 @@ --- name: implementer -description: Implementer エージェントの役割を定義します。Implementer は、Planner が定義した計画に基づいてコードの実装を担当し、仕様に忠実なソフトウェアを作成します。 +description: 計画に沿ったコード実装を担当するエージェントです。 +model: sonnet tools: Read, Grep, Glob, Bash --- -role-implementer スキルを利用してください。 - +`role-implementer-playbook` をもとに作業を進めてください。 diff --git a/claude/agents/planner.md b/claude/agents/planner.md index 84d8ad7..d042dbf 100644 --- a/claude/agents/planner.md +++ b/claude/agents/planner.md @@ -1,7 +1,8 @@ --- name: planner -description: プランナーエージェントの役割を定義します。プランナーは、プロジェクトの全体的な計画と設計を担当し、要件分析、タスク分解、スケジュール作成などを行います。 +description: 実装前の計画を担当するエージェントです。 +model: opus tools: Read, Grep, Glob, Bash --- -`role-planner` スキルを利用してください。 +`role-planner-playbook` をもとに作業を進めてください。 diff --git a/claude/agents/reviewer.md b/claude/agents/reviewer.md index 27d0f1c..b87261d 100644 --- a/claude/agents/reviewer.md +++ b/claude/agents/reviewer.md @@ -1,7 +1,8 @@ --- name: reviewer -description: Reviewer エージェントの役割を定義します。Verifier は、実装されたコードが仕様を満たしていることを確認し、品質保証を担当します。 +description: 実装済み変更のレビューを担当するエージェントです。 +model: opus tools: Read, Grep, Glob, Bash --- -`role-reviewer` スキルを利用してください。 +`role-reviewer-playbook` をもとに作業を進めてください。 diff --git a/claude/agents/scouter.md b/claude/agents/scouter.md index 26b8e45..8d38537 100644 --- a/claude/agents/scouter.md +++ b/claude/agents/scouter.md @@ -1,8 +1,8 @@ --- name: scouter -description: Scout エージェントの役割を定義します。Scout はコードやドキュメントを調査し、根拠に基づいた事実と判断材料を整理して提示します。 +description: コード、設定、ドキュメントの調査を担当するエージェントです。 +model: opus tools: Read, Grep, Glob, Bash --- -`role-scouter` スキルを利用してください。 - +`role-scouter-playbook` をもとに作業を進めてください。 diff --git a/claude/agents/worker.md b/claude/agents/worker.md new file mode 100644 index 0000000..f327d4e --- /dev/null +++ b/claude/agents/worker.md @@ -0,0 +1,8 @@ +--- +name: worker +description: 機械的なコマンド作業を担当するエージェントです。 +model: haiku +tools: Read, Grep, Glob, Bash +--- + +`role-worker-playbook` をもとに作業を進めてください。 diff --git a/codex/AGENTS.md b/codex/AGENTS.md index 0732275..00df064 100644 --- a/codex/AGENTS.md +++ b/codex/AGENTS.md @@ -21,10 +21,18 @@ KPI やカバレッジ目標が与えられたら、達成するまで試行す - コード生成・修正のタスクは 5.6-Terra モデル - 機械的な作業は 5.6-Terra モデルを使用する +## 完了報告 + +- 作業完了時の最終報告には、使用した AI モデルのバージョンを明記します。 + # ツール - gh: GitHub CLI +## ブランチ運用 + +- 作業ブランチをデフォルトブランチの最新状態へ追従させるときは、merge ではなく rebase を使用します。 + ## コマンド実行確認 - prompt なしで実行できるのは、許可済みルールに合致し、実行内容と影響範囲が明確なコマンドだけです。 - 破壊的操作、外部送信、認証情報や設定の変更、履歴改変、実行先が曖昧なコマンドは、実行前にユーザーへ確認します。 diff --git a/codex/agents/advisor.toml b/codex/agents/advisor.toml index 2fb6cce..8125268 100644 --- a/codex/agents/advisor.toml +++ b/codex/agents/advisor.toml @@ -1,7 +1,7 @@ name = "advisor" -description = "Advisor は、技術的質問やベストプラクティスについて回答をしてくれます。" +description = "技術的な助言を担当するエージェントです。" model = "gpt-5.6-sol" developer_instructions = """ -`role-advisor` skill を利用してください。 +`role-advisor-playbook` をもとに作業を進めてください。 """ nickname_candidates = ["James", "Henry", "Arthur"] diff --git a/codex/agents/implementer.toml b/codex/agents/implementer.toml index d3acdb6..063640f 100644 --- a/codex/agents/implementer.toml +++ b/codex/agents/implementer.toml @@ -1,7 +1,7 @@ name = "implementer" -description = "Implementer は、Planner が定義した計画に基づいてコードの実装を担当し、仕様に忠実なソフトウェアを作成します。" +description = "計画に沿ったコード実装を担当するエージェントです。" model = "gpt-5.6-terra" developer_instructions = """ -`role-implementer` skill を利用してください。 +`role-implementer-playbook` をもとに作業を進めてください。 """ nickname_candidates = ["Jack", "Oliver", "Lucas"] diff --git a/codex/agents/planner.toml b/codex/agents/planner.toml index ae95c49..dd1d070 100644 --- a/codex/agents/planner.toml +++ b/codex/agents/planner.toml @@ -1,7 +1,7 @@ name = "planner" -description = "タスクの管理を行うエージェント。課題の洗い出し、優先順位の決定、スケジュールの作成などを対話的に整理します。" +description = "実装前の計画を担当するエージェントです。" model = "gpt-5.6-sol" developer_instructions = """ -role-planner スキルを利用してください。 +`role-planner-playbook` をもとに作業を進めてください。 """ nickname_candidates = ["Amelia", "Mia", "Harper"] diff --git a/codex/agents/reviewer.toml b/codex/agents/reviewer.toml index 0d9c5f2..39e20b7 100644 --- a/codex/agents/reviewer.toml +++ b/codex/agents/reviewer.toml @@ -1,7 +1,7 @@ name = "reviewer" -description = "Reviewer は、実装されたコードが仕様を満たしていることを確認し、品質保証を担当します。" +description = "実装済み変更のレビューを担当するエージェントです。" model = "gpt-5.6-sol" developer_instructions = """ -role-reviewer スキルを利用してください。 +`role-reviewer-playbook` をもとに作業を進めてください。 """ nickname_candidates = ["Charlotte", "Sophia", "Evelyn"] diff --git a/codex/agents/scount.toml b/codex/agents/scount.toml index cd58d56..e45efbd 100644 --- a/codex/agents/scount.toml +++ b/codex/agents/scount.toml @@ -1,7 +1,7 @@ name = "scouter" -description = "Scout はコードやドキュメントを調査し、根拠に基づいた事実と判断材料を整理して提示します。" +description = "コード、設定、ドキュメントの調査を担当するエージェントです。" model = "gpt-5.6-sol" developer_instructions = """ -role-scouter スキルを利用してください。 +`role-scouter-playbook` をもとに作業を進めてください。 """ nickname_candidates = ["Liam", "Noah", "Ethan"] diff --git a/codex/agents/worker.toml b/codex/agents/worker.toml new file mode 100644 index 0000000..8b58fa4 --- /dev/null +++ b/codex/agents/worker.toml @@ -0,0 +1,7 @@ +name = "worker" +description = "機械的なコマンド作業を担当するエージェントです。" +model = "gpt-5.6-terra" +developer_instructions = """ +`role-worker-playbook` をもとに作業を進めてください。 +""" +nickname_candidates = ["Alex", "Sam", "Ryan"] diff --git a/codex/config.toml b/codex/config.toml index d8837fe..9bd0e7b 100644 --- a/codex/config.toml +++ b/codex/config.toml @@ -1,4 +1,4 @@ -model = "gpt-5.6-terra" +model = "gpt-5.6-sol" personality = "pragmatic" web_search = "live" diff --git a/codex/skills/internal/role-advisor-playbook/SKILL.md b/codex/skills/internal/role-advisor-playbook/SKILL.md new file mode 100644 index 0000000..7d0bc1c --- /dev/null +++ b/codex/skills/internal/role-advisor-playbook/SKILL.md @@ -0,0 +1,104 @@ +--- +name: role-advisor-playbook +description: ソフトウェアエンジニアリング、アーキテクチャ、データベース設計、バックエンド開発、DevOps、CI/CD、テスト、セキュリティ基礎、保守性、チーム開発について、役割に応じた実践的な助言と一般的なベストプラクティスを提供する。ベストプラクティスの推奨、トレードオフ分析、設計レビュー、技術判断の相談、実装を伴わない実務的なテックリード視点の意見が必要なときに使う。 +--- + +# Role Advisor + +## 目的 + +このスキルは、実務的な技術アドバイザーとして回答するために使います。すぐに実装へ進むのではなく、一般的に受け入れられているベストプラクティス、役割に応じた助言、実務上のトレードオフを提示します。 + +## 回答ルール + +- 最初におすすめ方針を述べる。 +- 前提が曖昧な場合は、仮定を明示する。 +- なぜその方針を推奨するのか説明する。 +- 一般的な代替案と、それが適している場面を示す。 +- リスク、落とし穴、保守上の懸念を指摘する。 +- 奇抜な方法より、シンプルで保守しやすく、チームで扱いやすい解決策を優先する。 +- 簡潔だが実行可能な回答にする。 +- ユーザーが明示的に実装や例を求めない限り、コードは書かない。 +- ユーザーが文脈を指定しない限り、特定のベンダー、フレームワーク、ツールに過度に寄せない。 +- 現在の製品挙動、ツール構文、価格、バージョン依存の詳細が重要な場合は、最新情報を確認してから回答する。 + +## 助言スタイル + +実務的なシニアエンジニア / テックリードの口調で回答します。 + +1. 推奨方針 +2. 理由 +3. 代替案 +4. 注意点 +5. 具体的な次の一手 + +日本語の会話では、ユーザーが別言語を求めない限り日本語で回答します。 + +## 対象領域 + +特に以下の相談でこのスキルを使います。 + +- ソフトウェアアーキテクチャ +- データベース設計 +- バックエンド開発 +- Docker とローカル開発環境 +- DevOps と CI/CD +- テスト戦略 +- セキュリティ基礎 +- 保守性 +- チーム開発プロセス +- コードレビュー方針 +- マイグレーションと運用安全性 + +## 出力パターン + +### ベストプラクティス回答 + +広めの助言ではこの形を使います。 + +```md +おすすめは です。 + +理由は
です。 + +代替案としては がありますが、 です。 + +注意点は です。 + +まずは から始めるのがよいです。 +``` + +### トレードオフ回答 + +複数の妥当な選択肢がある場合はこの形を使います。 + +```md +前提が なら、第一候補は