YasuakiOmokawa/skills
開発効率化スキル群。提供する開発スタイルは2つ：
- 上流開発 ... AIでプロトタイプを高速で作って、コード設計とデザインドキュメントを成果物として作成するスキル
- 下流開発 ... デザインドキュメントを基にタスクを切ってコード実装し、プルリクエストを成果物として作成するスキル
クイックスタート
npx skills add YasuakiOmokawa/skills
対話で必要な skill を選んで install。
設定値の生成
npx skills add ではリポジトリ本体は手元に落ちないため、設定生成スクリプトは clone して実行:
git clone https://github.com/YasuakiOmokawa/skills && bash skills/scripts/setup.sh
これで ~/.claude/skills-config/jira.md などが生成される。全プロジェクト横断で参照されるグローバル設定で、プロジェクトを切り替えても同じ設定が効く。
clone せずに、examples/skills-config/*.example.md を ~/.claude/skills-config/ へ手動でコピーして編集する方法でもよい。
Plugins
engineering 系 (設定不要で動く)
日常の開発作業で使う汎用 plugin。プロジェクト非依存で、追加設定なしに動く。
プラン駆動
| Plugin | 役割 |
|---|---|
model-data | 要求文書から DBML 形式の ER 図を生成 |
map-user-stories | 設計書から UserStory/Task を分解 |
define-acceptance-criteria | 分析ファイルに受け入れ条件を定義 (プランには 1 行サマリー) |
mece-plan-review | 受け入れ条件を BB/WB 2 視点 + Red Team で MECE 検証 (既定 inline、リスク領域は並列 deep) |
review-design | 「どこに・どう作るか」を判定 |
finalize-plan | プラン→実装可能形式へ変換 |
polish-before-commit | コミット前の自動仕上げ |
プロトタイプ駆動 (PoC → プロトタイプ → DD の 3 段連鎖)
| Plugin | 役割 |
|---|---|
build-poc | やりたいことを技術調査 → 星取表 → 最小実装で裏どりして PoC 化 |
build-prototype | PoC を既存コードベース慣習に合わせ DD を起こせる水準のプロトタイプへ実装 |
create-design-doc | プロトタイプと申し送りから DD (Design Doc) を作成 |
単独動作
| Plugin | 役割 |
|---|---|
iterate-with-prototypes | 未検証仮定のある複雑機能を code-first(動かしてから設計)で本番まで回す |
extract-figma-spec | Figma 指定を全プロパティ抽出しチェックリスト照合して反映漏れを防ぐ |
qa-ui | QA-ID 台帳から実行手順書を組み立て人間に検証委譲 (browser automation は明示指定時のみ) |
review-code-quality | 設計レベルの品質問題を検出 |
express-intent-in-code | 機構名/形状名を目的(why)表明形へ変換し why コメント依存を減らす |
create-pr | カレントブランチから PR 作成 (既定 draft、明示指示で ready for review) |
dry-ssot-text | AI-generated document を SSOT に統合 |
purge-private-vocab | plan 由来の固有語を対外文書から除染 |
review-plan-diff | 確定プランと実装後の diff を突き合わせ実装漏れ・仕様逸脱を検出 |
personal 系 (環境・組織依存の設定が必要)
利用者が自社の Jira 設定を ~/.claude/skills-config/jira.md に置いて使う前提の plugin。
| Plugin | 役割 |
|---|---|
create-jira-issues | プランから Jira チケット一括作成 |
set-jira-story-points | Story Points 一括設定 |
career 系 (ユーザー個人設定が必須)
~/.claude/skills-config/vision.md に自分のビジョン要素を書かないと動かない。
| Plugin | 役割 |
|---|---|
translate-to-vision-story | プロジェクト活動を Zenn 記事下書きに翻訳 |
設定値の保管 (グローバル)
設定値は ~/.claude/skills-config/*.md に保管される。ユーザーマシンに 1 セットだけあれば、全プロジェクトから同じ設定が読まれる。
開発ワークフローの推奨例
プロトタイプ駆動で、DDまで作成
/build-poc
/build-prototype
/create-design-doc
単発の設計 => 実装
プランファイルをつくって /grill-with-docs
/review-design
/define-acceptance-criteria
/mece-plan-review
/finalize-plan
/dry-ssot-text → /purge-private-vocab → /cognitive-rhythm-writing
/express-intent-in-code のガイドラインで実装。コミットは指示まで禁止
/review-plan-diff
/qa-ui
/simplify
/vercel-react-best-practices
/vercel-composition-patterns
/react-doctor
/review-code-quality
/express-intent-in-code
/polish-before-commit
コードコメントと md ファイルに /dry-ssot-text → /purge-private-vocab → /cognitive-rhythm-writing
/create-pr
出典
上のワークフロー例には、このリポジトリに含まれない外部配布 skill も混ざっている。npx skills add YasuakiOmokawa/skills では install されないため、必要なら各配布元から個別に入れる。
- grill-with-docs ... https://github.com/mattpocock/skills
- cognitive-rhythm-writing ... https://gist.github.com/k16shikano/eb2929f13ed19c97188393d297be8432
- vercel-react-best-practices / vercel-composition-patterns ... https://github.com/vercel-labs/skills
- react-doctor ... 外部配布 skill (本リポには含まれない)
ライセンス
MIT。詳細は LICENSE を参照。