HumanLayer

成果物ファイルに付いたレビューコメントを読み、指示に沿って修正・調査・返信・解決を進めるスキル。コメントを一件ずつ扱い、対応方針を確認しながら進めます。

• レビュー指摘を文書に反映したいとき
• コメントの指摘事項を調査したいとき
• 調査結果をコメントに返信したいとき

既存の技術設計書を、フィードバックや一問ずつの対話を通じて改善します。構成要素間の動きとコードの構造を分け、決定事項を図や説明に反映して整えます。

• フィードバックで技術設計書を直したいとき
• 未決定の設計方針を一つずつ詰めたいとき
• 構成要素の連携とコード構造の整理

構成の概要と設計・調査資料をもとに、具体的な実装計画書を作ります。段階ごとの変更手順やコード例、テストと手動確認の合格条件を整理するスキルです。

• 構成の概要から実装計画を作りたいとき
• 段階ごとのコード変更を具体化したいとき
• 検証コマンドと合格条件を決めたいとき

既存の実装計画にレビューの指摘を反映し、工程の分け方やコード例、ファイルパスを確認しながら、実行可能な自動チェックと具体的な手動確認を整えるスキル。

• レビュー後に実装工程を組み替えたいとき
• 計画内のコード例やパスを修正したいとき
• 成功条件と検証手順の具体化

チケットや調査資料を基に、実装方法を具体化する技術設計書を対話で作るスキル。システム全体の構成を固めてから、コード内部の設計を図や型で整理します。

• チケットや調査資料から技術設計したいとき
• 構成要素の連携とデータの流れの比較
• コード構成や関数の型を設計したいとき

タスクごとにGitの作業ディレクトリとブランチを用意します。共有設定とローカル設定に従い、必要なファイルのコピーや初期設定、複数リポジトリの準備を進めます。

• タスク専用の作業場所を準備したいとき
• 環境ファイルやローカル設定を引き継ぐ
• 複数リポジトリのworktreeをまとめて準備

Storybookの表示例を本番のUI部品で作成・レビューし、表示用部品と業務ロジックを分け、操作デモの命名や配置、部品の組み合わせ方をそろえるスキル。

• 本番UI部品の固定データ表示例を作りたいとき
• ダイアログや切り替え操作のデモ作成
• 表示例を含む変更の部品分離レビュー

既存のoRPC処理を一件ずつEffectへ移行し、ルートや応答形式、認可条件を保ちながら、DB操作・エラー処理・ログ・ルーター接続を置き換えるスキル。

• oRPC処理を一件ずつ移行したいとき
• DBクエリやトランザクションの移行
• 移行時のエラー処理とログの置き換え

既存のコード調査文書を読み込み、説明の薄い箇所や未解決の疑問を追加調査し、記述の正確さを検証して、ファイル位置や実装の詳細を補いながら自律的に更新するスキル。

• 既存の調査文書を詳しくしたいとき
• コードの動作や参照情報の検証
• コードベースの未解決事項の調査

既存の技術設計書をフィードバックに沿って見直し、構成やデータの流れ、コード構造の選択肢を図で示しながら、一つずつ判断を固めて文書へ反映するスキル。

• 技術設計書に指摘を反映したいとき
• 未決定の構成やコード構造の比較
• データの流れや役割を図で整理したいとき

既存のコード調査文書を、指摘や追加の疑問に沿って更新します。現在の実装やデータの流れを追加調査し、ファイル名・行番号を根拠に、一貫した説明へまとめ直します。

• 既存のコード調査文書への追記
• 指摘に基づく説明の修正
• データの流れや処理間の連携調査

リリース時に対象パッケージの基準バージョンを更新し、関連ファイルの同期と生成結果を検証して、コミットからPRブランチへのプッシュまで進めるスキル。

• リリース用のバージョンを更新したいとき
• 関連ファイルのバージョン表記の同期
• プッシュ前の生成バージョン検証

複雑な処理を小さなインターフェースにまとめる設計を支援します。共通の用語と判断基準を使い、モジュールの役割分担や依存関係、テストのしやすさを見直せます。

• モジュールの使い方を簡潔にしたいとき
• 処理を差し替える接点の見直し
• テストしやすい依存関係の設計

HumanLayerをCLIから操作し、作業用ディレクトリを分けたタスクの起動、進行状況やPRの確認、成果物の移動・アップロードまでを扱うスキル。

• 作業場所を分けてタスクを起動したいとき
• タスクの状態やPRを確認したいとき
• 成果物をコピー・アップロードしたいとき

既存の製品要件書をフィードバックに沿って見直し、未決定事項を一つずつ対話で固めながら、決まった内容を本文と画面の試作に反映して仕様を具体化するスキル。

• 既存の要件書にフィードバックを反映したいとき
• 未決定の製品仕様を一つずつ固めたいとき
• 画面案をHTMLの試作で比較したいとき

画面やUI部品の試作を、CSSとJavaScriptを含む単一のHTMLにまとめます。暗色の統一テーマで状態の違いや操作の注釈を示すスキルです。

• 実装前に画面構成を検討したいとき
• 通常時やエラー時を比較したいとき
• 注釈付きのUI案を共有したいとき

コードの変更履歴や設計資料を踏まえて構造改善の候補を探し、変更前後の図を含むHTMLレポートで比較したうえで、選んだ案の制約やテスト方針を掘り下げるスキル。

• 変更が多いコードの改善候補探し
• 構造改善案を変更前後の図で比較
• テストしやすい構造の検討

既定ブランチの変更を作業ブランチへ取り込み、競合した双方の変更内容と意図を整理します。解消案を示し、利用者の確認を受けながらマージを進めるスキル。

• 既定ブランチの更新を取り込みたいとき
• 既存のマージ競合の内容を知りたいとき
• 競合の解消方針を確認したいとき

Riptideの変更をローカル環境で操作し、画面の結果と保存データを検証します。開発環境の準備からブラウザ操作、CLIでのタスク作成、データベース確認まで扱います。

• Riptideの変更動作を検証したいとき
• ローカル開発環境の準備と稼働確認
• CLIでのテスト用タスク・セッション作成

Effect v4を使うアプリの設計・実装・レビュー・テストを支援します。依存関係やエラーの型を明確にし、外部連携、並行処理、ログまで一貫した方針で整えます。

• 依存関係を明確にサービスを設計したいとき
• エラー処理やログを見直したいとき
• データベースや外部APIと連携したいとき

アイデアや課題を、一問ずつの対話で製品要件書にまとめるスキル。解決する問題と成功指標を固め、機能や利用体験を整理し、画面案も交えて仕様を具体化します。

• 曖昧なアイデアを要件にまとめたいとき
• 解決する問題と成功指標を合意したいとき
• 画面案で操作や配置を比較したいとき

計画や設計について一問ずつ掘り下げ、判断のつながりを整理しながら共通理解を作ります。各質問には推奨案を添え、コードから分かる点は調査して確かめます。

• 計画を質問で掘り下げたいとき
• 設計判断を依存関係順に整理したいとき
• 判断ごとの推奨案を相談したいとき

リベース後に競合したDrizzleのマイグレーションを診断し、履歴やスナップショットを整理して、スキーマ変更の再生成と適用後の検証を進めるスキル。

• リベース後の競合を修復したいとき
• マイグレーション履歴の重複整理
• 意図したスキーマ変更の再生成

変更依頼と調査結果をもとに、実装前の設計案を文書化します。現状と目標、選択肢の利点・欠点を整理し、利用者の判断とその理由を記録するスキルです。

• 実装前に設計の選択肢を比較したいとき
• 現状と目指す振る舞いを整理したいとき
• 図やコード例で構成を検討したいとき