開発のスキル

コードの開発課題を、対話による要件確認から仕様書・作業チケットの作成、実装まで順に進めます。各段階の承認と実際のテスト、レビューの証拠を残すスキルです。

• 実装前に要件を詰めたいとき
• 承認済み仕様を作業に分けたいとき
• テストとレビュー付きで実装したいとき

開発用スキルを使う前に、課題の管理先、仕分け用ラベル、設計資料の配置を整えるスキル。既存の設定を調べ、利用者が確認した内容をリポジトリに記録します。

• 開発用スキルの初期設定
• 課題の管理先を選びたいとき
• 既存の仕分けラベルを引き継ぐ

指定したコミットやブランチを基準に、コード変更を規約への適合と仕様の実現という二つの観点で並行レビューします。それぞれの指摘を分けて報告するスキルです。

• ブランチやPRをレビューしたいとき
• 指定コミット以降の変更確認
• 仕様の実装漏れや余分な変更の確認

仕様書や作業チケットに沿ってコードを実装し、型チェックとテストで確認します。完了後のコードレビューから現在のブランチへのコミットまで進めるスキルです。

• 仕様書から機能を実装したいとき
• チケットに沿って開発したいとき
• 型チェックとテストを伴う実装

現在の作業と分けて機能開発を始められるよう、既存の分離環境を確認し、必要に応じて作業場所を作成して、依存関係の準備と開始前のテストを行うスキル。

• 新機能用の作業場所を分けたいとき
• 実装計画の実行前に環境を確認したいとき
• 既存の worktree を使いたいとき

作りたい機能や修正内容を伝えると、OpenSpecの変更として提案・設計・仕様・実装タスクを順に作成し、依存関係と完了状態を確認して実装に進める資料を揃えます。

• 機能のアイデアを提案にしたいとき
• 設計・仕様・実装タスクの一括準備
• 修正内容を実装前に文書化したいとき

実際のコードから小さな改善課題を選び、OpenSpecの提案・仕様・設計・タスク作成から実装、アーカイブまでを解説付きで一通り体験できる入門スキル。

• OpenSpecの全工程を実践で学びたいとき
• 初回の練習に適した小さな改善の選定
• 提案・仕様・設計のつながりを学びたいとき

仕様や要件を、担当者が順に実行できる細かな実装計画へ整理します。変更ファイル、具体的なコード、テスト手順と期待結果、コミットまで明記するスキルです。

• 要件を実装計画へ落とし込みたいとき
• 開発作業を別の担当者へ引き継ぐとき
• テスト先行の実装手順を整理したいとき

機能のアイデアや開発中の疑問を、対話と既存コードの調査で整理します。図や比較表で選択肢とリスクを見える形にし、実装に進む前の要件や設計の検討を支援します。

• 曖昧な機能案を整理したいとき
• 既存コードの構造や問題の調査
• 技術の選択肢を比較したいとき

互いに依存しない複数の不具合や作業をエージェントへ並行して割り当て、必要な情報と担当範囲を絞り、結果の確認と変更の統合まで進めるスキル。

• 原因の異なるテスト失敗を調べたいとき
• 独立した複数の不具合を修正したいとき
• 担当ごとの作業指示を整理したいとき

複数の開発変更をまとめてアーカイブし、成果物やタスクの完了状況を確認しながら、仕様の重複を実装と照合して整理し、仕様本体への反映と結果報告を行うスキル。

• 完了した複数の変更をまとめて整理したいとき
• 成果物とタスクの完了状況を確認したいとき
• 重複する仕様変更を整理したいとき

作りたい機能や修正内容をもとに、OpenSpecで実装開始に必要な資料を依存関係の順にまとめて作成します。個別に手順を進めず、実装に着手できる状態へ整えるスキル。

• 新機能に必要な資料をまとめて準備したいとき
• バグ修正の依頼を実装計画にまとめたいとき
• 関連資料を依存関係の順に作りたいとき

バグやテスト失敗、予期しない動作の根本原因を調べてから修正するスキルです。再現手順と証拠を集め、正常な実装との比較、仮説検証、修正後の確認まで進めます。

• テストやビルドの失敗原因を調査
• 複数のシステムにまたがる障害の切り分け
• 修正しても直らない不具合の再調査

機能追加や不具合修正の要望から、OpenSpecの変更用フォルダを作成し、必要な文書の作成順序と現在の状態、最初のテンプレートを示すスキル。

• 機能追加の作業を準備したいとき
• 不具合修正を順序立てて始めたいとき
• 必要な文書と作成順を確認したいとき

開発の依頼内容と進行中の変更を確認し、設計・実装・検証・アーカイブの適切な段階へ振り分け、不具合修正や小規模変更にも対応するスキル。

• 新機能の開発を始めたいとき
• 中断した変更を再開したいとき
• 不具合修正や小規模変更を進めたいとき

変更分の仕様を主仕様へ反映し、要件の追加・修正・削除・改名を整理するスキル。変更対象外の内容を保ち、変更をアーカイブせずに仕様を更新します。

• アーカイブ前に主仕様を更新したいとき
• 既存シナリオを残して追加したいとき
• 要件の追加・削除・改名の反映

実装を終えたOpenSpecの変更について、成果物やタスクの完了状況、仕様の同期状態を確認し、日付付きの保管先へ移して作業の区切りをつけます。

• 実装済みの変更をアーカイブしたいとき
• 終了前に未完了タスクを確認したいとき
• 保管前に仕様への反映内容を確認したいとき

OpenSpecの変更に紐づく仕様や設計資料を読み、未完了タスクを順に実装します。完了項目と進捗を更新し、曖昧な要件や問題は確認を求めます。

• 準備済みのOpenSpecタスクを実装
• 途中まで実装した変更を再開したいとき
• 進捗を記録しながら残りのタスクを実装

実装後のテスト結果とGitの作業環境を確認し、マージ・PR作成・保留・破棄の選択から、選んだ手順の実行と不要なブランチの後片付けまでを案内します。

• 完成したブランチをマージしたいとき
• 変更をPRとして提出したいとき
• 取り込みを後日に保留したいとき

機能追加や動作変更の前に、対話で目的・制約・成功条件を整理し、複数の案を比較します。承認した設計を仕様書にまとめ、実装計画へつなぐスキル。

• 新機能の要件を整理したいとき
• 動作変更の実装案を比較したいとき
• 大規模な依頼を分割したいとき

進行中のOpenSpecの変更について、現在の進捗と依存関係を確認し、次に必要な文書を1つ作成します。提案・仕様・設計・タスクの整備を順番に進めるスキルです。

• 進行中の変更の文書作成を再開
• 提案に続く仕様を作りたいとき
• 設計上の判断を文書化したいとき

実装内容・要件・対象コミットを整理して別のエージェントにコードレビューを依頼し、タスク完了時やマージ前に問題を見つけ、重要度に応じた対応につなげるスキル。

• 完了した開発タスクのレビュー
• 大きな機能が要件を満たすか確認
• マージ前にレビューを依頼したいとき

文書化された実装計画を別のセッションで引き継ぎ、計画の疑問点を確認してから各タスクと指定の検証を順に進め、開発完了の手続きにつなぐためのスキル。

• 文書化した実装計画を別セッションで進めたいとき
• 実装前に計画の不足を確認したいとき
• 指定された検証とともにタスクを実行したいとき

AIエージェント向けのスキルを新規作成・改修し、導入前後の動作を比較して改善します。SKILL.mdの構成や検索されやすい説明文、検証方法も整理します。

• 実証済みの手法をスキル化したいとき
• 守られない指示を改善したいとき
• 導入前にスキルを検証したいとき