version-1/agents-docs - Seite 2

format-pr-description

GitHub Pull Request の description を定義済みフォーマットで作成・更新するときに使う。PR 番号、diff、コミット履歴をもとに、Summary、主な変更点、やったこと、動作確認、レビュアー向けチェックリスト、必要に応じた Mermaid 図を一貫したテンプレートへ整理する。PR 本文、PR description、pull request の説明文、レビュー向け説明を整える依頼では必ず使う。

Quellsprache: Japanisch

lego-programming

設計、計画、実装方針、実装、リファクタリング、コードレビュー、UI 分割、モジュール設計、責務分離、レイヤリング、コンポーネント設計を行うときに使う。コードを書く前の計画や設計レビュー、実装中、完了前、差分レビュー時に、機能を高凝集・疎結合な「レゴ」として境界づけ、組み合わせ、見直すための設計ガードレールを提供する。特に「責務が混ざっている」「どこで分けるべきか」「実装前に構成を決めたい」「計画段階で部品境界を確認したい」「既存コードにどう配置するか」「再利用できる部品にしたい」「この差分の部品境界をレビューしたい…

Quellsprache: Japanisch

code-naming

関数名、メソッド名、クラス名、型名、変数名、定数名、ファイル名、ディレクトリ名などコード上の命名をレビューし、責務、抽象度、既存語彙、検索性、呼び出し側の読みやすさ、ユーザーの命名の好みに基づいて候補を出すときに使う。名前候補を比較したい、既存名を改善したい、命名の一貫性を確認したい、曖昧な名前、過度に汎用的な名前、コンテキストと重複した冗長な名前を直したいときに使う。

Quellsprache: Japanisch

code-typo

指定範囲のコード、diff、ファイルパス、コミットメッセージ、PR タイトル、PR 説明に含まれる typo やスペル違いを指摘するときに使う。コード変更や設計レビューは行わず、ファイル / 行、誤字、推奨スペル、確認範囲を報告する。

Quellsprache: Japanisch

role-doc

Doc として、変更理由、設計判断、影響範囲、運用注意、読み手に残すべき背景を文書化するときに使う。README や手順書の体裁よりも、未来の理解コストを下げるために何を言語化すべきかを判断する。

Quellsprache: Japanisch

code-react

React / JSX / TSX / .jsx / .tsx 実装を書く前に、コンポーネント設計、Atomic Design を補助観点にした UI 分割、hooks、props、state、UI 実装の責務分離を確認するときに使う。

Quellsprache: Japanisch

code-tracer

コードベース内の特定シンボル、関数、メソッド、型、モジュールについて、callers / callees / both の呼び出し経路を根拠付きで追跡し、Markdown や Mermaid で可視化するときに使う。言語ごとの構造化された解析手順を選び、根拠と限界を明示する。

Quellsprache: Japanisch

code-css

CSS / .css / Sass / SCSS / .scss 実装を書く前に、layout、responsive design、selector、cascade、保守しやすいスタイル設計を確認するときに使う。

Quellsprache: Japanisch

code-go

Go / .go 実装や Go テストを書く前に、goroutine、interface、error handling、標準的な設計、テスト方針、既存コードへの合わせ方を確認するときに使う。

Quellsprache: Japanisch

code-ruby

Ruby / Rails / .rb 実装や RSpec / Minitest テストを書く前に、Active Record、MVC、言語・フレームワーク設計、テスト方針、既存コードへの合わせ方を確認するときに使う。

Quellsprache: Japanisch

code-ts

TypeScript / .ts / .tsx 実装を書く前に、型設計、interface / type、strict typing、責務分離、既存コードへの合わせ方を確認するときに使う。

Quellsprache: Japanisch

component-design

デザインカンプ、スクリーンショット、HTML、既存画面、仕様メモなどの Input から React / Next.js / TypeScript の UI を実装する前に、画面構成、構成要素ツリー、コンポーネント境界、props、hooks、状態管理、実装順序を設計するために使う。新規画面作成、既存画面への UI 追加、大きな JSX の分割、UI…

Quellsprache: Japanisch

agent-retro

直近のエージェント作業を振り返り、最初に知っていれば遠回りしなかった知見を抽出して、skill、AGENTS.md、CLAUDE.md などの再利用可能なルールへ反映するときに使う。反映前に変更内容をユーザーへ確認する。

Quellsprache: Japanisch

ci-fix

GitHub Actions や CI の失敗を調査し、原因を切り分けて修正するときに使う。ユーザーが「CI 落ちてる」「GitHub Actions 直して」「workflow が失敗」「checks が red」「test failure を直して」「lint/build が CI でだけ落ちる」などを依頼した場合は必ず使う。gh CLI、workflow ログ、ローカル再現、最小修正、再検証、PR 反映までを安全な順序で進める。

Quellsprache: Japanisch

cmd-batch

広範囲のコードベース調査、横断的な修正、複数領域にまたがるテスト・検証を、複数エージェントや並列作業に分割して進めるときに使う。大規模な変更の担当範囲、調査観点、編集所有権、統合、競合回避、検証順序を整理する必要がある場合に使う。

Quellsprache: Japanisch

cmd-commit

Git リポジトリで変更内容を確認し、適切な粒度とメッセージで安全に commit を作成するときに使う。ユーザーが「commitして」「コミット作って」「差分をコミット」「変更を分けてコミット」「この変更をコミット」などを依頼した場合に使う。git status / diff / log を確認し、未確認の変更や unrelated changes を勝手に含めず、必要に応じて commit 粒度、stage 対象、commit message を整理する。

Quellsprache: Japanisch

cmd-rmbranch

Git リポジトリのローカルブランチを整理し、main と develop 以外の不要ブランチを安全に削除するときに使う。リモートブランチやコードは変更せず、保護ブランチ、カレントブランチ、未マージブランチの扱いを確認してから実行する。

Quellsprache: Japanisch

code-general

言語固有の実装スキルが適用できない、または言語をまたぐ既存コードベースの機能追加、修正、リファクタリングで守る共通原則と進め方を定義する。仕様や公開契約を壊さず、既存構造、命名、責務境界に合わせて小さく安全な差分を作るときに使う。Go 実装では code-go など該当する言語別スキルを併用し、レビューのみは code-review を優先する。

Quellsprache: Japanisch

code-test

テストケース設計、回帰テスト追加、テストコードレビュー、テスト戦略の整理を行うときに使う。正常系、異常系、境界値、データ整合性、互換性、性能、flake、モック方針を検討し、変更に対する安心感を高めつつ維持コストを抑える。

Quellsprache: Japanisch

format-rich-html-diagram

コード、アーキテクチャ、React コンポーネント構造、データフロー、状態管理、シーケンス、処理フロー、依存関係、ディレクトリ階層などを、SVG、2D、3D、アニメーション、CDN ライブラリを使ったリッチな単一 index.html として可視化・整理するときに使う。開発者がブラウザで index.html だけを開けば全体像、詳細、関係性、判断材料を理解できる成果物を作る必要がある場合は必ず使う。Markdown…

Quellsprache: Japanisch