Quality and Evals

Quality and Evals

superpowers-ja manages quality with audit scripts, release notes, and eval transcripts.

superpowers-ja は audit scripts、release notes、eval transcripts で品質を管理します。

Audit

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

Category	Checks
Static validation	JSON parse、SKILL.md frontmatter、symlink、hook permissions
Installer behavior	install / reinstall / uninstall for supported tools
Upstream alignment	hooks、brainstorm scripts、core skill structure drift、full skill drift report
Cross references	README links、skill references、bootstrap paths

For upstream sync review:

node scripts/check-upstream-skill-drift.js upstream/main

Eval Transcripts

Original Japanese skills are evaluated with practical scenario transcripts.

Eval	Scenario
japanese-incident-report	顧客向け障害最終報告
japanese-acceptance-test-spec	注文 CSV export の受入テスト仕様
japanese-code-review-graph	影響範囲 review と test gap
japanese-code-review	権限・監査ログを含む PR review
japanese-git-workflow	本番 hotfix の branch / PR / release 運用
japanese-documentation	外部連携 API の保守引き継ぎ document
japanese-commit-conventions	日本語 commit と changelog entry

Release Checklist

Release 前の version sync、audit、npm pack --dry-run、eval transcript 確認手順は docs/release-checklist.md に整理しています (v0.3.0 で追加)。

Done Criteria

• Japanese wording fits SIer、受託開発、自社サービス contexts
• Requirements、acceptance criteria、impact、evidence、approval are explicit
• Behavior-changing instructions are preserved
• node bin/superpowers-ja.js --help passes
• bash scripts/audit.sh --quick passes
• Updated skills are included in npm pack --dry-run --json