Skip to content
Conduit

skill

superpowers-ja

日本のIT開発現場向けSuperpowers。AI coding agentに計画、TDD、レビュー、検証、Backlog/Redmine/Jiraを前提にした日本語ワークフローを追加します。

sscodeai/superpowers-jacommunitylistedunreviewed
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/sscodeai/superpowers-ja itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 26, 2026

superpowers-ja

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

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

特徴

項目内容
Skills23 個: 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-graphcode-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-workflowGitHub / GitLab / Bitbucket / Backlog / Redmine / Jira を前提にしたブランチ、PR/MR、CI 運用/japanese-git-workflow
japanese-documentation仕様書、設計書、README、API 仕様の日英混在ルールと日本語表現/japanese-documentation
japanese-commit-conventionsConventional 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-branchPR、マージ、保持、破棄を判断
writing-skills新しい skill の作成と検証
using-superpowersskills の使い方を定義するメタ skill

Optional integrations

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

Tool用途Skill
code-review-graphcode 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
OpenClawskills/OpenClaw
DeerFlowskills/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-sitesuperpowers-ja と agency-agents-ja の docs、tutorial、blog hub。
local-agent-toolkitagent に 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 integrityREADME の docs link、skill 間参照、bootstrap 後の必須 path

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

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

License

MIT

↑↓ navigate openesc close