shokai-agent-skills

作者がAIとの対話の中で伝えてきた心得を集めたガイドライン群。Agent SkillやAI向けのルール文書、ソースコード中のコメント、ソフトウェアテストを書く時、GitHubでpull requestを作りmergeする時に、何を書き、何を書かないかの判断基準を定める。どこに書く時も変わらない文章の書き方も定める。subagentに作業を任せる指揮役の振る舞いと、ユーザーの判断を得る時の振る舞いも定める。

9 skills

リポジトリを領域ごとに巡回するセキュリティ調査スキル。観点チェックリストに基づき未調査領域を調査し、Codexの批判的レビューを経てレポート出力する。複数session前提の長期作業。起動したsessionが指揮役になり、領域ごとに起動したsubagentが調査する。レポートの問題のトリアージと、自動修正、状態同期も行う。

7 skills

dependabotやrenovateが作成した依存関係の更新pull requestを、リポジトリごとに決めた自動化段階までレビュー・修正・mergeする指揮。起動したsessionが指揮役になり、pull requestごとに起動したsubagentがレビューと修正を行う。起動プロンプトの作成と、Claude Code on the webのroutineへの登録も行う。

5 skills

対話コンテキストのexport/importスキル。会話で共有された目的・意図・設計判断・制約条件を .dev/contexts/ に書き出してPRコメントにも投稿し、別セッションやレビューで親子PRのコメント欄からも探して読み込む。1対多のコンテキスト共有により、複数の子PRをまとめた親PRのレビューやコードの自動改善に便利。

2 skills

Software Factory 2026秋の開発フローをsessionに適用するmode skill。着手前に不明点をユーザーに質問、変更が一段落したらcodexでbug確認、draft PR作成、対話コンテキストexport、インラインレビューコメントの草稿、ユーザーの指示でsanity-review、ready for review後のsquash and mergeのcommit message草稿の提示、という進め方を定める。開発の開始時にユーザーが手動で起動する。

2 skills

Codex CLIにセカンドオピニオンを求めるスキル。「codexと相談して」「codexに聞いて」で発動する。

1 skill

deprecated。代わりにdependency-updateを使う。ライブラリ更新pull requestのレビュー手順。dependabot/renovatebot PRの分析、release note調査、コード更新、過去の失敗調査を行う。

1 skill

Claude Codeのremote session(claude --rc)をtmux内に新しく起動し、URLを伝えるスキル。remote controlで繋いだsessionに「〇〇のclaude session作って」と頼むと、別のディレクトリで新しいsessionを作れる。

1 skill

PRのレビュー報告書を作成する。bugや脆弱性の調査だけでなく、exportされた対話コンテキスト・PR概要欄・実装されたコードの整合性を確認し、実装者の正気を疑う。

1 skill

Agent SkillやCLAUDE.md等のルール文書のように、AIが読んで従う文書のusability testを行うスキル。下位tierのmodelのsubagentに、ゴールを与えて観察し、終了後にインタビューとtranscriptの監査で、文書の記述を根拠に完遂できたかを確かめる。

1 skill

Agentツール（subagent）にセカンドオピニオンを求めるスキル。「subagentと相談して」「subagentに聞いて」で発動する。

1 skill

定石外発想で実装をシンプルにする。現状の発展型ではなく、実装の裏にある暗黙の前提条件を1つずつ外し、よりシンプルな別解がないか検討する。

1 skill