version-1/agents-docs

cmd-start-branch

Git リポジトリで新しい作業を始める前に、最新のデフォルトブランチへ追従し、タスク内容に合う作業ブランチを作成して、不要なローカルブランチ整理を非同期に依頼するときに使う。ユーザーが「ブランチ切って」「作業を始める準備して」「新しいタスク用ブランチを作って」「最新 main から始めたい」などを依頼した場合はこの skill を使い、ブランチ名を報告してからタスク詳細の入力を待つ。

Source text: Japanese

issue-finder-playbook

Issue Finder agent がコードベースを変更せず、指定された finder 分野の課題を根拠付きで調査し、優先順位付けした Markdown を指定ディレクトリへ出力するときの共通手順、安全制約、品質基準、出力 contract を定義する。

Source text: Japanese

role-vulnerability-finder

コード、設定、依存関係、権限境界にある悪用可能な脆弱性を安全に調査し、コードを変更せず課題レポートへ整理するため issue-finder agent に委譲するときに使う。一般的なコードレビュー、侵入や攻撃の実行、脆弱性修正には使わない。

Source text: Japanese

role-bug-finder

コードベースに潜む再現可能な不具合、仕様違反、境界条件や異常系の欠陥を発見し、コードを変更せず課題レポートへ整理するため issue-finder agent に委譲するときに使う。実装済み差分のマージ可否レビュー、修正の実装、保守性だけの評価、脆弱性が主題の調査、文書だけの不整合調査には使わない。

Source text: Japanese

role-bug-finder-playbook

Issue Finder agent がコードベースの実際の不具合、仕様違反、境界条件や異常系の欠陥を発見するときに使う分野別の探索観点、課題判定、重要度基準、誤検知の除外条件を定義する。

Source text: Japanese

role-documentation-finder-playbook

Issue Finder agent がドキュメントの欠落、重複、矛盾、情報配置、導線、読み手や粒度の混在、progressive disclosure の問題を発見するときに使う分野別の探索観点、課題判定、重要度基準を定義する。

Source text: Japanese

role-documentation-finder

ドキュメントの欠落、重複、矛盾、配置や導線、読み手と粒度の混在、progressive disclosure の問題を発見し、既存文書を変更せず課題レポートへ整理するため issue-finder agent に委譲するときに使う。文書の新規作成や修正には使わない。

Source text: Japanese

role-feature-finder-playbook

Issue Finder agent がコードベース内の利用者課題、未完了仕様、不自然な制約を根拠として機能提案を発見するときに使う分野別の探索観点、提案判定、重要度基準、誤検知の除外条件を定義する。

Source text: Japanese

role-feature-finder

README、仕様、TODO、既存 UI/API、テストなどから利用者の未解決課題を特定し、根拠のある機能提案をコード変更なしで課題レポートへ整理するため issue-finder agent に委譲するときに使う。根拠のないアイデア出しや機能実装には使わない。

Source text: Japanese

role-maintenance-finder-playbook

Issue Finder agent がコードベースの保守性、責務境界、複雑性、重複、変更容易性、テスト容易性の問題を発見するときに使う分野別の探索観点、課題判定、重要度基準、誤検知の除外条件を定義する。

Source text: Japanese

role-maintenance-finder

コードベースの責務混在、複雑性、重複、変更困難性、テスト困難性など保守性の課題を発見し、コードを変更せず課題レポートへ整理するため issue-finder agent に委譲するときに使う。不具合の検証、機能提案、リファクタリング実装には使わない。

Source text: Japanese

role-vulnerability-finder-playbook

Issue Finder agent がコード、設定、依存関係、認証・認可、信頼境界にある悪用可能な脆弱性を安全に発見するときに使う分野別の探索観点、課題判定、重要度基準、検証制約を定義する。

Source text: Japanese

beautify-commit

Git リポジトリで、ベースブランチまたは残したい履歴の終点 commit との差分に含まれる commit や巨大な未整理差分を、意味のある変更単位ごとに整理して commit し直すときに使う。ユーザーが「commit を分割して」「巨大なコミットを分けて」「連続コミットを整理して」「履歴をきれいにして」「この差分を変更単位でコミットして」「ベースブランチとの差分を整理して」などを依頼した場合に使う。基準 ref の指定を確認し、指定がなければデフォルトブランチでよいか yes/no で確認する。git…

Source text: Japanese

cmd-create-pr

GitHub Pull Request を安全な手順で作成または更新するときに使う。ユーザーが「PR 作って」「PR 出して」「pull request 作成して」「この変更を PR にして」「pr を出す手順を進めて」などを依頼した場合は必ず使う。差分確認、検証、commit、最新 base branch への追従、role-reviewer による PR 前レビュー、High 指摘の自動対応、grape push、PR description 作成、gh pr create / edit…

Source text: Japanese

role-gardener-playbook

Gardener として Git と GitHub の機械的な操作を安全に実行するときに使う。clone、checkout、pull、push、rebase、worktree、log、および gh による repository、Pull Request、Issue の情報取得や PR の作成・更新を担当し、内容の解釈、文書作成、コード実装、レビュー、テストは行わない。

Source text: Japanese

role-documenter-playbook

Documenter として、README、ADR、Runbook、API Docs、開発者向け文書、ガイド、仕様、進捗などを作成・更新するときに使う。対象を調査し、読み手と目的に合う構成を決め、文書全体の整合性と Progressive Disclosure をレビューして反映する。

Source text: Japanese

role-documenter

技術文書の作成・更新を Documenter agent に委譲するときに使う。README、ADR、Runbook、API Docs、開発者向け文書、ガイド、仕様、進捗などを調査し、構成を決め、読み手に伝わる文書として作成・レビューする必要があるときに使う。コード実装、事実調査だけの依頼、実装計画、技術判断、実装済み差分のレビューだけが目的なら使わない。

Source text: Japanese

documenting

README、ADR、Runbook、API Docs、開発者向けドキュメント、コードコメントなど、技術文書を作成・更新するときに使う。変更理由、影響範囲、互換性、運用注意、戻し方を整理し、未来の開発者が最短で理解できる文書にする。

Source text: Japanese

role-advisor

技術的な助言を Advisor agent に委譲するときに使う。実装を始める前のアーキテクチャ、設計、技術選定、トレードオフ、ベストプラクティス、リスク、方針判断について専門的な意見が必要なときに使う。コードや設定の実装、事実調査、実装済み差分のレビュー、実装計画の作成だけが目的なら使わない。

Source text: Japanese

role-gardener

Git と GitHub の機械的な操作を Gardener agent に委譲するときに使う。clone、checkout、branch、pull、push、rebase、worktree、log、commit 履歴の取得、および gh による repository、Pull Request、Issue の取得・作成・更新などを依頼するときに使う。コード実装、テスト、差分や Issue の内容解釈、レビュー、PR 本文の考案が目的なら使わない。

Source text: Japanese

role-implementer

コードや設定の実装を Implementer agent に委譲するときに使う。合意済みの仕様、計画、スコープ、Definition of Done に沿った機能追加、バグ修正、テスト追加など、ファイル変更と検証が必要なときに使う。実装前の調査や計画、技術判断だけの相談、実装済み差分のレビュー、挙動維持の構造改善を統括する依頼には使わない。

Source text: Japanese

role-planner

実装前の計画作成を Planner agent に委譲するときに使う。要件からゴール、スコープ、タスク、依存関係、リスク、未解決事項、Definition of Done を整理し、Implementer と Reviewer が実行・検証できる計画が必要なときに使う。コード実装、事実調査、技術選定の助言、実装済み差分のレビューだけが目的なら使わない。

Source text: Japanese

role-refactor

挙動と公開契約を維持するリファクタリングの設計と進行を Refactor agent に委譲するときに使う。重複、長い関数、深い条件分岐、責務混在、密結合などを改善するため、変更後の構造を設計し、実装とレビューの反復まで統括するときに使う。機能追加、仕様変更、単純な実装、レビューだけの依頼には使わない。

Source text: Japanese

role-reviewer

実装済みの差分、PR、コミット、指定ファイルのレビューを Reviewer agent に委譲するときに使う。仕様適合、公開契約、回帰、境界条件、セキュリティ、データ整合性、責務、検証不足を確認し、マージ前や実装後のリスクを指摘してほしいときに使う。実装前の計画、コード変更の実装、事実調査だけが目的なら使わない。

Source text: Japanese

role-scouter

コード、設定、ドキュメント、履歴の調査を Scouter agent に委譲するときに使う。実装前に現状、原因、影響範囲、関連箇所、呼び出し経路、既存仕様を根拠付きで明らかにし、不確実性を下げる必要があるときに使う。コード変更、実装計画の作成、技術判断、実装済み差分のレビューだけが目的なら使わない。

Source text: Japanese

role-worker

判断をほとんど要しない機械的な作業を Worker agent に委譲するときに使う。実行内容と対象が明確なコマンド実行、定型的なファイル操作、テスト・lint・build・検証、情報収集を任せるときに使う。設計、技術判断、コード実装、原因調査、レビュー、Git / GitHub 専門操作には使わない。

Source text: Japanese

cmd-dispatch-agent

指定された agent を起動し、結果を待たずに投げっぱなしで作業を開始させるときに使う。ユーザーが「agent を立ち上げて」「worker に投げて」「scouter を走らせて」「結果を待たずに」「投げっぱなし」など、明示的にサブエージェント起動を依頼した場合は必ず使う。明示依頼がなくても、タスクが単純で不明瞭な点がなく、自己完結していて結果待ちが直近のブロッカーにならない場合は、この skill で agent に任せてよい。

Source text: Japanese

role-refactor-playbook

Refactor として、既存の挙動と公開契約を維持する変更後の構造を Modification Design として設計し、Implementer と Reviewer の反復を導くときに使う。

Source text: Japanese

role-implementer-playbook

Implementer として、Planner が定義したゴール、スコープ、Definition of Done に従って実装を行うときに使う。既存コードの流儀に合わせ、小さく安全な差分で仕様に忠実なコードと必要な検証を作る。実装時は code-general も併用する。

Source text: Japanese

role-advisor-playbook

ソフトウェアエンジニアリング、アーキテクチャ、データベース設計、バックエンド開発、DevOps、CI/CD、テスト、セキュリティ基礎、保守性、チーム開発について、役割に応じた実践的な助言と一般的なベストプラクティスを提供する。ベストプラクティスの推奨、トレードオフ分析、設計レビュー、技術判断の相談、実装を伴わない実務的なテックリード視点の意見が必要なときに使う。

Source text: Japanese

role-planner-playbook

Planner として、実装前にゴール、スコープ、タスクリスト、Definition of Done、依存関係、リスク、未解決事項を整理するときに使う。実装コード、擬似コード、diff、具体的な設定例は出さず、Implementer と Reviewer が迷わない計画を作る。

Source text: Japanese

role-reviewer-playbook

Reviewer として、実装済みの差分が仕様、スコープ、公開契約、品質要件を満たしているか検証するときに使う。実装者の前提や正常系中心の説明を鵜呑みにせず、見落とされた失敗条件を疑う基本姿勢で敵対的検証を行い、リスク、回帰、境界条件、責務違反、検証不足を根拠付きで言語化し、必要に応じて code-review も併用する。

Source text: Japanese

role-scouter-playbook

Scouter として、コード、ドキュメント、設定、履歴を調査し、根拠に基づく事実、判断材料、未解決点を整理するときに使う。実装やレビュー判断を急がず、不確実性を下げるための探索結果を再現可能な形で提示する。

Source text: Japanese

role-worker-playbook

Worker として、コマンド実行、定型的なファイル操作、検証など、明確に定義された機械的な作業を安全に行うときに使う。

Source text: Japanese

code-next-developer-review

実装済みの差分、PR、コミット、指定ファイルを「次に開発する人が困らないか」という観点でレビューするときに使う。実装者の前提や正常系中心の説明を鵜呑みにせず、後続開発で見落とされる失敗条件や迷いやすさについて敵対的検証を行い、変更箇所の見つけやすさ、責務境界、命名、型・契約、テストの読みやすさ、前提知識の残し方、追加ケースの足しやすさ、ローカル検証のしやすさを確認したい場合に使う。欠陥、仕様違反、セキュリティ、データ破壊の検出を主目的にする場合は code-review を優先する。

Source text: Japanese

code-quality-review

実装済みの差分、PR、コミット、指定ファイルを code quality report の観点でレビューし、実装者の前提や正常系中心の説明を鵜呑みにせず、将来の変更・テスト・運用で品質問題が表面化する条件について敵対的検証を行い、保守性、設計健全性、責務分離、複雑度、テスト容易性、変更容易性、技術的負債を観点別に評価するときに使う。cyclomatic complexity、cognitive complexity、coverage、重複率、関数長、lint/static analysis…

Source text: Japanese

code-review

実装済みの差分、PR、コミット、指定ファイルをレビューし、実装者の前提や正常系中心の説明を鵜呑みにせず、見落とされた失敗条件を疑う基本姿勢で敵対的検証を行い、仕様違反、回帰、公開契約破壊、セキュリティ、データ整合性、並行性、検証不足などのリスクを重要度順に指摘するときに使う。実装方針の相談は code-refactor、コード変更の実装は code-general を優先する。

Source text: Japanese

cmd-agent-status

現在のエージェントのタスク状況、進捗、実行中または保留中の作業、ブロッカー、次に行うことをユーザーへ簡潔に報告するときに使う。ユーザーが「今どうなっている」「ステータス」「進捗」「何をしている」「止まっているか」などを尋ねた場合に使う。

Source text: Japanese

modification-design

実装前に、既存コードや仕様を根拠として、変更後のシステム構造を Modification Design に整理するときに使う。ユーザーが「変更後の設計」「実装前の設計」「何をどう変えるか」「責務、interface、contract、依存関係、影響、リスクを整理して」などを求めた場合は必ず使う。Plan のような実装手順やタスクリストではなく、変更対象となるモジュール、コンポーネント、API、型、データの変更後の責務と境界をレビュー可能な自然言語で定義する。コード、擬似コード、diff は出力しない。

Source text: Japanese

code-refactor

コードレビュー結果、code quality report、git diff、PR 差分、指定ファイルをもとに、挙動を変えずにコードを簡略化・リファクタリングするためのスキル。可読性、保守性、テスト容易性、複雑度、効率性、技術的負債の指摘を実装に反映し、変更範囲と検証結果を簡潔に報告するときに使う。ユーザーが quality report や code-quality-review の結果をもとに改善してほしいと言った場合も使う。

Source text: Japanese