開発のスキル

GitHub Issueの要件と受け入れ条件を整理し、専用worktreeを用意して、テストを先に書く開発作業を始めるスキルです。

• GitHub Issueの実装を始めたいとき
• 変更を専用worktreeで分けたいとき
• 受け入れ条件からテスト駆動で進めたいとき

プルリクエストを出す前に、ブランチの更新状況、lint・テスト、原則との整合性、RFCやドキュメントを確認し、提出準備の課題をまとめます。

• PR作成前に変更の準備状況を確認したいとき
• lintやテストの漏れを確認したいとき
• API変更のRFC要否を調べたいとき

プルリクエストのCIとGreptileレビューを監視し、失敗や指摘への対応を繰り返して状態を報告します。

• PR提出後のCIを監視したいとき
• Greptileのレビューを待ちたいとき
• CI失敗の修正を反復したいとき

複数のGitHub issueを作業単位ごとのworktreeに分け、Agent Teamsで並行して進めます。TDDを有効にし、作業結果を積み上げ式のPRにまとめます。

• 複数の小〜中規模issueをまとめて進めたいとき
• 独立したGitHub issueを並行作業したいとき
• issueごとのworktreeを準備したいとき

`openenv` CLIでOpenEnv環境のひな形を作り、検証・ビルド・プッシュまで進めるためのコマンドと基本手順を案内します。

• OpenEnv環境のひな形を作りたいとき
• プロジェクトをビルド前に検証したいとき
• 環境をビルドしてプッシュしたいとき

テストが通ったコードの動作を変えずに、不要な処理や複雑さを整理して読みやすく保守しやすい形に整えるリファクタリングスキルです。

• テスト通過後にコードを整理したいとき
• 不要な処理や使われないコードを減らしたいとき
• プルリクエスト前に読みやすく整えたいとき

変更内容がRFC（設計提案書）の対象かを、API変更や新しい設計方針などの基準と既存RFCに照らして判断し、根拠を整理します。

• 新しいAPI追加にRFCが必要か確認したいとき
• 互換性を壊す変更の要否を判断したいとき
• 大きな設計変更の進め方を検討するとき

具体的な用途に合わせてOpenEnvの環境を設計・実装し、モデルやクライアント、サーバー、設定ファイルまで一式を組み立てるスキルです。

• ライブラリ向けのOpenEnv環境を作りたいとき
• APIをエージェント用環境として包みたいとき
• 行動・観測・報酬の仕様を決めたいとき

`/write-tests` が作成した失敗中のテストを読み、要件を満たす最小限のコードを追加して、すべてのテストが通るまで進めるスキルです。

• 失敗中のテストに必要な実装をしたいとき
• テストで示された要件だけを実装したいとき
• TDDの実装段階を進めたいとき

コード変更をバグや機械的な問題、OpenEnvの設計原則やRFCとの整合性の観点から確認し、すぐ直す項目と議論が必要な懸念を分けて報告するスキルです。

• PRのバグや設計上の問題を確認したいとき
• コミット前にコードを点検したいとき
• デバッグコードやLint違反を見つけたいとき

TLA+モデルや合意済みの状態図からMermaidの状態遷移図を作り、規則に反するバグを番号付きの経路として示して、検討や修正の根拠をまとめます。

• バグに至る状態遷移を図で示したいとき
• サービスやプロダクトの動作を合意したいとき
• TLA+仕様と既存コードを照合したいとき

Grok BotをWebhookで起動するページやダッシュボードを作り、送信キーをサーバー側で扱ってTailscale経由で共有する手順を案内します。

• ボタンでボットを起動する画面を作りたいとき
• Webhookにフォーム内容を送りたいとき
• 送信キーをブラウザーに置かず管理したいとき

手作業では追いにくい編集、分析、確認を、再実行できるスクリプトや生成器に置き換え、レビュー時に確かめられる成果物として残します。

• 一括編集を再実行可能にしたいとき
• 移行結果を確認する仕組みを作りたいとき
• 定型ファイルを一貫して生成したいとき

同じ依頼に複数の案を並行して作り、基準に沿って比較したうえで、最良案に他案の優れた部分を統合し、成果物を検証します。

• 複数の設計案を比較したいとき
• 大きな成果物の方向性を決めたいとき
• 複数の草案から長所を組み合わせたいとき

実装前にデータ構造や型、作業の順序を整理し、共有状態や並行処理のリスクも考えながら、後続のコードを単純に保つ設計指針を示します。

• 実装前にデータ構造を決めたいとき
• 型やデータモデルを整理したいとき
• 準備作業と機能開発の順を決めたいとき

コードベースの構成や処理の流れを調べ、機能の仕組み、コードの置き場所、担当パッケージや適切な層を把握するための説明をまとめます。

• 初めて触る機能の仕組みを知りたいとき
• 変更前に処理の流れを把握したいとき
• コードの置き場所や担当層を判断したいとき

計画済みの書き換えや移行で、途中の互換性維持より目標の構成への到達を優先し、区切りごとに確認する進め方を示します。

• 段階的なシステム移行を計画したいとき
• 目標アーキテクチャへ書き換えたいとき
• 一時的な互換対応の範囲を決めたいとき

TypeScriptのコードを読む・編集するとき、型で不正な状態を防ぎ、外部データの検証や網羅性の確認まで一貫した実践ルールに沿って進めます。

• TypeScriptコードをレビューしたいとき
• 型で不正な状態を防ぎたいとき
• 外部データの検証方法を整えたいとき

複数の編集や移行を小さな単位に分け、各変更を確認してから次へ進みます。コミットやPRも検証の順に並べ、レビューしやすくまとめるスキルです。

• 一括編集を一件ずつ検証したいとき
• 移行作業を安全な順序で進めたいとき
• レビューしやすいコミットを積みたいとき

既存設計に新しい要件を加える際、後付けの継ぎ足しを避け、最初から要件があった前提で全体を見直し、関連する型や文書、例まで変更を反映します。

• 既存設計に新要件を加えたいとき
• 継ぎ足しになった設計を見直したいとき
• 関連する型やドキュメントも更新したいとき

リファクタリングや差分の見直しで、不要な抽象化や重複した判断を減らし、問題を解く最小限の変更に絞るスキルです。

• 変更差分を最小限に整理したいとき
• 新しい抽象化が必要か見直したいとき
• 重複した判断を一元化したいとき

静的型付け言語で、値の意味や入力元に合った型を設計し、無効な状態や未処理の分岐を型と検査で見つけやすくします。

• IDなど同じ基本型の値を区別したいとき
• JSONや設定値を型付きデータに変換したいとき
• 選択肢の分岐漏れを確認したいとき

既存の手順では進めにくい大規模な変更に、仮説検証と判断記録を組み込んだ、後から追跡できる作業計画を設計するスキルです。

• 大規模な移行手順を設計したいとき
• 複数段階の変更を分割して進めたいとき
• 後から監査できる作業記録を残したいとき

実装に入る前に型や関数の形、モジュール構成を複数案から設計し、選んだ設計を実装中も基準にして、形が合わなければ設計から見直すスキルです。

• 機能実装前に型や構成を設計したいとき
• 複数の設計案を比較したいとき
• 実装中の回避策が増え設計を見直したいとき