superpowers-ja

AI コーディングのための Superpowers 日本語・日本 IT 開発版です。

Upstream の obra/superpowers をベースに、汎用的な開発 skills を日本語化し、日本の SIer、受託開発、自社サービス開発でよく使うレビュー、Git、ドキュメント、コミット運用を追加しています。

特徴

項目	内容
Skills	23 個: upstream 系 14 個 + 日本向け 7 個 + 追加ワークフロー 2 個
対応ツール	Claude Code / Cursor / Codex / Gemini CLI / OpenCode / Kiro / Windsurf / Aider / Trae / Qoder / VS Code Copilot など
日本向け要素	Backlog / Redmine / Jira、GitHub / GitLab / Bitbucket、稟議・承認・証跡、丁寧だが曖昧にしないレビュー、日英混在ドキュメント
インストール	npx superpowers-ja でプロジェクト内の AI 開発ツールを自動検出

何が変わるか

superpowers なし:

あなた: ユーザー一覧に CSV エクスポートを追加して
AI: 実装します
AI: exportUsers() を追加しました
あなた: 仕様と違う。文字コード、権限、大量データ、監査ログは?

superpowers-ja あり:

あなた: ユーザー一覧に CSV エクスポートを追加して
AI: 実装前に確認します。
    1. 文字コードは Shift_JIS / UTF-8 どちらですか?
    2. 想定件数と非同期処理の要否は?
    3. 権限、個人情報、監査ログの要件はありますか?
    4. Backlog / Jira のチケット番号はありますか?

日本向け Skills

下記 7 つは日本の IT 開発現場向けに追加した skill です。レビュー、報告、文書化など、日本語で証跡を残す場面を補強します。

Skill	用途	呼び出し
japanese-code-review	日本のチームで使いやすいレビュー表現、指摘レベル、承認前チェック	/japanese-code-review
japanese-code-review-graph	code-review-graph 任意導入時の影響範囲、risk、test gap レビュー	/japanese-code-review-graph
japanese-incident-report	障害初報、続報、最終報告、原因分析、再発防止策の整理	/japanese-incident-report
japanese-acceptance-test-spec	顧客検収、UAT、受入条件、証跡付きテスト仕様の整理	/japanese-acceptance-test-spec
japanese-git-workflow	GitHub / GitLab / Bitbucket / Backlog / Redmine / Jira を前提にしたブランチ、PR/MR、CI 運用	/japanese-git-workflow
japanese-documentation	仕様書、設計書、README、API 仕様の日英混在ルールと日本語表現	/japanese-documentation
japanese-commit-conventions	Conventional Commits を日本語チームで運用するための commit / changelog 規約	/japanese-commit-conventions

Upstream 系 Skills

Skill	用途
brainstorming	実装前に要求、制約、設計方針を整理
writing-plans	仕様を実装計画へ分解
executing-plans	計画をチェックポイント付きで実行
test-driven-development	テストを先に書いて実装
systematic-debugging	不具合を根本原因から調査
requesting-code-review	完了前にレビュー agent を依頼
receiving-code-review	レビュー指摘を技術的に検証して反映
verification-before-completion	完了宣言前に検証コマンドを実行
dispatching-parallel-agents	独立タスクを並列 agent に分配
subagent-driven-development	サブ agent とレビューを使って実装
using-git-worktrees	作業を隔離する git worktree 運用
finishing-a-development-branch	PR、マージ、保持、破棄を判断
writing-skills	新しい skill の作成と検証
using-superpowers	skills の使い方を定義するメタ skill

Optional integrations

下記は任意導入です。npx superpowers-ja では外部 tool を自動 install しません。

Tool	用途	Skill
code-review-graph	code graph と blast radius analysis を使い、PR/MR の影響範囲、risk、test gap を整理	japanese-code-review-graph

code-review-graph を使う場合は、対象 repository 側で公式手順に従って install / build / MCP 設定を行ってください。未導入の project では通常の japanese-code-review または requesting-code-review を使います。

クイックスタート

cd /path/to/your/project
npx superpowers-ja

自動検出できない場合:

npx superpowers-ja --tool claude
npx superpowers-ja --tool cursor
npx superpowers-ja --tool codex
npx superpowers-ja --tool gemini

対応 tool、alias、install 先を事前に確認する場合:

npx superpowers-ja --list-tools

ユーザーのホームディレクトリ (~) にはインストールしないでください。プロジェクトごとの CLAUDE.md、GEMINI.md、skills ディレクトリへ bootstrap を追加する設計です。

対応ツール

ツール	インストール先	ガイド
Claude Code / Copilot CLI	.claude/skills/	Claude Code
Cursor	.cursor/skills/	Cursor
Codex CLI	.codex/skills/	Codex
Gemini CLI	.gemini/skills/	Gemini CLI
OpenCode	.opencode/skills/	OpenCode
Aider	.aider/skills/	Aider
Kiro	.kiro/steering/	Kiro
Windsurf	.windsurf/skills/	Windsurf
Trae	.trae/skills/	Trae
VS Code Copilot	.github/superpowers/	VS Code Copilot
Hermes Agent	.hermes/skills/	Hermes Agent
Antigravity	.agents/skills/	Antigravity
OpenClaw	skills/	OpenClaw
DeerFlow	skills/custom/	DeerFlow
Qwen Code	.qwen/skills/	Qwen Code
Claw Code	.claw/skills/	Claw Code
Qoder	.qoder/skills/ + .qoder/rules/	Qoder

アンインストール

cd /path/to/your/project
npx superpowers-ja --uninstall

インストール済みの skill ディレクトリと、CLAUDE.md / GEMINI.md / HERMES.md / CONVENTIONS.md に追加した superpowers-ja セクションを削除します。既存の手書き内容は保持します。

開発方針

この fork は「日本の現場で AI agent がそのまま使える作法」を重視します。

• レビューは丁寧に、ただし重大度は曖昧にしない
• 仕様、受入条件、影響範囲、検証証跡を残す
• チケット番号、PR/MR、CI 結果、リリースノートをつなげる
• 個人情報、監査ログ、障害対応、運用引き継ぎを実装前に確認する
• 日本語と英語の技術用語を自然に混在させる

今後の日本語化優先順位は ROADMAP.md に整理しています。

関連プロジェクト

Project	用途
agency-agents-ja	日本の IT 開発、SIer、受託開発、SaaS、EC、製造業 DX 向け AI 専門家 agent library。workflow-runner と組み合わせて複数 role の作業を進められます。
sscodeai-site	superpowers-ja と agency-agents-ja の docs、tutorial、blog hub。
local-agent-toolkit	agent に memory、skill 管理、実行 trace を追加する local-first toolkit。skillet を使うと skill 単位の配布・導入を整理できます。

品質監査

開発時は、変更範囲に応じて以下を実行してください。

bash scripts/audit.sh --quick --no-upstream
bash scripts/audit.sh

scripts/audit.sh は次を確認します。

Category	内容
静的検証	JSON parse、SKILL.md frontmatter、symlink、hook 実行権限
Installer 機能	対応 tool への install / reinstall / uninstall
Upstream alignment	上流と同期すべき hook、brainstorm script、主要 skill 構造の drift
Cross-reference integrity	README の docs link、skill 間参照、bootstrap 後の必須 path

CI では通常の audit を実行します。network や upstream remote が使えない環境では、ローカル確認として --quick --no-upstream を使えます。

release 前の version sync、package 内容、eval transcript の確認は Release Checklist にまとめています。

License

MIT