refactor(skills): simplify -ja skills to thin wrappers over English counterparts

nkoji21 · claude · nkoji21 · commit cf79da668b60 · 2026-03-26T21:18:40.000+09:00
Japanese skill variants were duplicating the full instruction set from their
English counterparts. Replaced with minimal wrappers that delegate to the
English skill and override only the output language, reducing context overhead.

Co-Authored-By: Claude &lt;noreply@anthropic.com&gt;
diff --git a/.agents/skills/git-commit-ja/SKILL.md b/.agents/skills/git-commit-ja/SKILL.md
@@ -4,63 +4,6 @@ description: Review changes and autonomously commit (Japanese)
 user-invocable: true
 ---
 
-Review current changes and autonomously commit following Conventional Commits.
+Use /git-commit to perform the commit, but write the commit message description **in Japanese**.
 
-1. Run `git status`, `git diff`, and `git log --oneline -5` to understand the changes and context
-2. Decide the commit message autonomously
-3. Stage and commit using `git apply` (see below)
-
-## Principle
-- Write **Why** (why the change was made) in the commit message. Leave What to the diff.
-- Each commit must be **independently revertable** without breaking other functionality.
-
-## Commit Granularity
-- 1 commit = 1 logical change
-- Examine individual hunks, not entire files — split if needed
-- Separate refactoring and feature additions
-- Tests can be in the same commit as the main code
-- Formatting-only changes should be separate
-
-## Staging with git apply
-
-Never use interactive commands like `git add -p`. Instead:
-
-```bash
-# 1. Generate patch for the target changes
-git diff > patch.diff
-
-# 2. Verify before applying (no file changes on failure)
-git apply --cached --check patch.diff
-
-# 3. Apply to staging area (equivalent to git add)
-git apply --cached patch.diff
-```
-
-If `git apply --cached` fails, try in order:
-1. `git apply --cached --whitespace=fix patch.diff`
-2. `git apply --cached --ignore-space-change patch.diff`
-3. Fall back to `git add <files>` for the specific files
-
-## Commit Message Format
-Conventional Commits v1.0.0
-
-Format: `type(scope): description`
-- scope: optional (e.g., `alacritty`, `vim`, `git`)
-- **description: in Japanese** (e.g., `feat(alacritty): 透明度設定を追加`)
-
-Types:
-- `feat`: new feature
-- `fix`: bug fix
-- `docs`: documentation only
-- `style`: formatting, whitespace
-- `refactor`: code change without bug fix or feature
-- `perf`: performance improvement
-- `test`: add/update tests
-- `build`: build system, dependencies
-- `chore`: other configs, tooling
-- `ci`: CI configuration
-
-Required footer:
-```
-Co-Authored-By: Claude <noreply@anthropic.com>
-```
+Example: `feat(alacritty): 透明度設定を追加`
diff --git a/.agents/skills/git-pr-ja/SKILL.md b/.agents/skills/git-pr-ja/SKILL.md
@@ -4,37 +4,4 @@ description: Review branch changes and autonomously open a PR (Japanese)
 user-invocable: true
 ---
 
-Review current branch changes and autonomously create a PR as draft.
-
-**Current branch:** `!`git branch --show-current``
-
-**Commits since main:**
-```
-!`git log --oneline main..HEAD`
-```
-
-**Diff stat:**
-```
-!`git diff --stat main...HEAD`
-```
-
-1. Run `git log --oneline main..HEAD` and `git diff main...HEAD` to understand the changes
-2. If a PR template exists in the project, follow it
-3. Autonomously decide the PR title and body, then create it with `gh pr create --draft`
-
-## PR Format (if no template exists)
-
-close #{issue_number}
-（関連issueがない場合はこの行を削除）
-
-## Summary
-なぜこの変更をしたか。実装内容ではなく動機を書く。
-
-## Changes
-変更の方針・構造レベルの概要のみ。実装詳細はFile Changesで確認できるので書かない。
-
-## Notes
-レビュアーに伝えるべき特記事項。不要なら削除。
-
-**日本語で記述。**
-**簡潔に。実装詳細はdiffに任せる。**
+Use /git-pr to create the PR, but write the PR title and body **in Japanese**.
diff --git a/.agents/skills/pr-flow-ja/SKILL.md b/.agents/skills/pr-flow-ja/SKILL.md
@@ -5,135 +5,8 @@ user-invocable: true
 allowed-tools: Bash, Skill, Agent
 ---
 
-ステージ済みの変更からsquash-mergeされたPRまで、プルリクエストの全ワークフローを自動化します。
+Use /pr-flow to run the full PR workflow, but with the following language overrides:
 
-**現在のブランチ:** `!`git branch --show-current``
-
-**作業ツリーの状態:**
-```
-!`git status --short`
-```
-
-## Phase 1: Worktree
-
-`git-worktree` スキルを Skill ツールで実行する。
-
-worktreeパス（例: `/tmp/feat-foo`）とブランチ名が返される。両方を保存する：
-- `WORKTREE_PATH` — worktreeへの絶対パス
-- `BRANCH_NAME` — worktree内に作成されたブランチ名
-
-## Phase 2: コミット
-
-コミット前の HEAD sha を記録する：
-```
-BEFORE_SHA=$(git -C $WORKTREE_PATH rev-parse HEAD)
-```
-
-`git-commit-ja` スキルを `--path $WORKTREE_PATH` 引数付きで Skill ツールで実行する。
-
-スキル完了後、コミットが実行されたか確認する：
-```
-AFTER_SHA=$(git -C $WORKTREE_PATH rev-parse HEAD)
-```
-
-`BEFORE_SHA == AFTER_SHA` の場合、worktreeをクリーンアップして停止する：
-```
-git worktree remove --force $WORKTREE_PATH
-```
-コミットする変更がなかったこと、元のリポジトリの変更はそのまま残っていることをユーザーに伝える。
-
-## Phase 3: PR作成
-
-`git-pr-ja` スキルを `--path $WORKTREE_PATH` 引数付きで Skill ツールで実行する。
-
-スキル完了後、PR URLを取得する：
-```
-cd $WORKTREE_PATH && gh pr view --json url --jq '.url'
-```
-
-`gh pr create` がPR既存エラーで失敗した場合は、同じコマンドで既存のPR URLを取得する。
-
-このURLを保存する — 以降の `gh pr comment` と `gh pr merge` の呼び出しで使用する。
-
-## Phase 4: レビューループ
-
-このループは最大 **3回** まで実行できる。イテレーション数を0から追跡する。
-
-### 4a. レビュアーサブエージェントの起動
-
-Agent ツールで `pr-reviewer` サブエージェントを以下のプロンプト（実際のPR URLに置き換え）で起動する：
-
-```
-Review the PR at <PR_URL>. Run `gh pr diff <PR_URL>` to get the diff. Analyze it for bugs, logic errors, security issues, and style/convention violations. Return structured findings exactly as your instructions specify — the REVIEW_RESULT block only, no prose outside it.
-```
-
-### 4b. レビューコメントの検証と投稿
-
-投稿前に、サブエージェントのレスポンスに `REVIEW_RESULT` ... `END_REVIEW_RESULT` ブロックが含まれているか確認する。ブロックが存在しないか不正な場合は、代わりに以下の警告を投稿してPhase 5に進む：
-```
-gh pr comment <PR_URL> --body "[Claude Codeによる自動レビュー] 警告：レビュアーが不正な出力を返しました。自動修正をスキップします。手動でレビューしてください。"
-```
-
-正常な場合は、結果を投稿する：
-```
-gh pr comment <PR_URL> --body "[Claude Codeによる自動レビュー]
-
-<フォーマットされたレビュー結果>"
-```
-
-結果はmarkdownリスト形式で。各項目: 重要度ラベル（`must-fix` / `suggestion` / `nitpick`）、ファイル/箇所、説明。
-
-### 4c. 結果の評価
-
-- **問題なし**（`issues: []` を含む）または **`suggestion`/`nitpick` のみ**: Phase 5に進む。
-- **`must-fix` が存在し、かつ iteration < 3**:
-  - 指摘されたファイルを読んでから編集する。各 `must-fix` 問題を修正する。
-  - git-commit 実行前の HEAD sha を記録する：
-    ```
-    FIX_BEFORE=$(git -C $WORKTREE_PATH rev-parse HEAD)
-    ```
-  - `git-commit-ja` スキルを `--path $WORKTREE_PATH` 引数付きで Skill ツールで実行して修正をコミットする。
-  - コミットが実際に行われたか確認する：
-    ```
-    FIX_AFTER=$(git -C $WORKTREE_PATH rev-parse HEAD)
-    ```
-  - `FIX_BEFORE == FIX_AFTER`（コミットなし）の場合: 修正をコミットできなかった旨のコメントを投稿し、worktreeをクリーンアップ（`git worktree remove --force $WORKTREE_PATH`）してから停止する。ループしないこと。
-  - イテレーション数をインクリメントして4aに戻る。
-- **`must-fix` が存在し、かつ iteration == 3**:
-  - コメントを投稿する：
-    ```
-    gh pr comment <PR_URL> --body "[Claude Codeによる自動レビュー] 自動修正の最大回数（3回）に達しました。残りのmust-fix問題は手動対応が必要です。"
-    ```
-  - worktreeをクリーンアップする：
-    ```
-    git worktree remove --force $WORKTREE_PATH
-    ```
-  - 停止する。マージには進まないこと。
-
-## Phase 5: LGTM + マージ
-
-LGTMコメントを投稿する：
-```
-gh pr comment <PR_URL> --body "[Claude CodeによるLGTM]
-
-must-fix問題は見つかりませんでした。自動マージを開始します。"
-```
-
-ドラフトPRをマージするために、レビュー準備完了にマークする：
-```
-gh pr ready <PR_URL>
-```
-
-squashマージをトリガーする：
-```
-gh pr merge <PR_URL> --squash --auto
-```
-
-マージコマンドが失敗した場合は、エラー内容をユーザーに報告して停止する。自動リトライはしないこと。
-
-マージ成功後、worktreeをクリーンアップする：
-```
-git worktree remove --force $WORKTREE_PATH
-```
-
-最終的なPR URLとマージ結果をユーザーに報告する。
+- Commit message descriptions: **in Japanese**
+- PR title and body: **in Japanese**
+- Review comments and status messages posted to the PR: **in Japanese**
