From update-issue-index
Use this skill whenever the user wants to refresh or regenerate `docs/issues/INDEX.md` from the current state of GitHub Issues, Pull Requests, and local/remote git branches. Triggers include Japanese phrases like "INDEX を更新して", "INDEX.md 再生成", "issue 一覧を最新にして", "インデックス更新", or English equivalents like "update issue index", "refresh INDEX.md", "regenerate issues index". This skill is **manual-fire only** — it is never wired into hooks. It runs `scripts/generate-index.sh`, which rewrites the table between `<!-- BEGIN_ISSUE_TABLE -->` / `<!-- END_ISSUE_TABLE -->` markers. The skill shows the diff to the user and only commits when the user explicitly asks for it. Trigger this even if the user doesn't explicitly say "skill" — any request to update / refresh / regenerate the issues index in this project should invoke it.
How this skill is triggered — by the user, by Claude, or both
Slash command
/update-issue-index:update-issue-indexThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
`docs/issues/INDEX.md` の「一覧」テーブルを、`gh` / `git` の現在状態から再生成する手動発火スキル。
docs/issues/INDEX.md の「一覧」テーブルを、gh / git の現在状態から再生成する手動発火スキル。
SDD 運用で issue / PR が増えるほど INDEX.md は実態と乖離しがちなので、任意のタイミングで一発更新できるようにしたもの。発火は手動のみで、hook 登録は行わない。
プラグインとしてインストールされると、スクリプトは ${CLAUDE_PLUGIN_ROOT%/}/skills/update-issue-index/scripts/ 配下に展開される。呼び出し時は bash の parameter expansion ${VAR%/} で末尾スラッシュを剥がす形で統一する(CLAUDE_PLUGIN_ROOT は末尾スラッシュ付きで展開されるため、そのまま連結すると // が混入する)。作業ディレクトリ(cwd)はユーザーのプロジェクトのままで OK。
| スクリプト | 役割 | 使い方 |
|---|---|---|
generate-index.sh | INDEX.md のテーブルをマーカー間で再生成 | bash "${CLAUDE_PLUGIN_ROOT%/}/skills/update-issue-index/scripts/generate-index.sh" [INDEX_FILE] |
INDEX_FILE 省略時は docs/issues/INDEX.md を対象にする。スクリプトは INDEX.md を in-place で書き換える。差分の提示とコミット判断は Claude(このスキル)側の責務。
docs/issues/INDEX.md には以下のマーカーが必要。スクリプトはこの 2 行の間をテーブルで置き換える。
<!-- BEGIN_ISSUE_TABLE -->
| # | タイトル | status | ブランチ | PR |
| --- | --- | --- | --- | --- |
| ... |
<!-- END_ISSUE_TABLE -->
マーカーが無い INDEX.md に対してはスクリプトがエラーで終了する。初回導入時はマーカーを手動で追加する。
bash "${CLAUDE_PLUGIN_ROOT%/}/skills/update-issue-index/scripts/generate-index.sh"
エラー終了したら内容をユーザーに報告して中断する。よくある原因:
gh auth login されていないgit diff -- docs/issues/INDEX.md
差分の有無で分岐する。
open → pr-open に変わった 等)を抜粋する。ユーザーに「コミットしますか?」と明示的に確認する。自動でコミットしない。
ユーザーが「コミットして」等の明示指示をしたら、次のコマンドでコミットする:
git add docs/issues/INDEX.md
git commit -m "docs: refresh issues INDEX.md"
コミットメッセージの書式はこの形式で固定(SDD 運用上、INDEX.md の更新はメタ作業なので Conventional Commits の docs: 固定でよい)。
ユーザーが「コミットしない」「確認だけ」等と言った場合は、書き換え済みの INDEX.md をワーキングツリーに残したまま終了する(ユーザーが手動で編集・コミット・捨てられる)。
スクリプトは各 issue に対して以下の順で status を判定する:
mergedpr-openissue-<N> をパス要素として含む)が存在 & PR 無し → in-progressopenclosedPR と issue の紐付けは以下のどちらかで判定する:
issue-<N> をトークンとして含む(例: feature/issue-7-foo, fix/issue-2)Closes #<N> / Fixes #<N> / Resolves #<N> を含む(大文字小文字問わず)複数候補がある場合: PR は OPEN > MERGED > CLOSED、ブランチはローカル優先(アルファベット順先頭)。
ユーザー: 「INDEX を更新して」
動き:
generate-index.sh を実行git diff → 差分なしユーザー: 「INDEX 最新にして」
動き:
generate-index.sh を実行git diff → issue #8 の行が追加、issue #2 が open → pr-open に変化+ | 8 | ... | open | - | - |- | 2 | ... | open | - | - | → + | 2 | ... | pr-open | fix/issue-2-... | #6 |git add + git commit -m "docs: refresh issues INDEX.md"<!-- BEGIN_ISSUE_TABLE --> / <!-- END_ISSUE_TABLE --> が無いとスクリプトはエラー終了する。初回導入時はユーザーに相談の上、マーカーを追加する(冒頭説明と「status の語彙」セクションはマーカー外なので保持される)。git push する。gh issue list --limit 1000 と gh pr list --limit 1000 を呼ぶ。1000 を超えるリポでは取りこぼしが起きる可能性あり(その時は --limit の調整が必要)。| が含まれるとテーブルが崩れるので、スクリプト側で \| にエスケープする。改行もスペースに変換する。in-progress と判定するが、実装を放棄したまま残っているブランチも in-progress になる。気になるときはユーザーが手動で該当ブランチを削除すれば次回の生成で正しい status に落ち着く。Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Applies a firm's KYC/AML rules grid to parsed onboarding records: assigns risk rating, checks required documents, outputs rule outcomes with citations, and routes for escalation.
Generates daily or weekly digests of activity from connected sources (chat, email, docs, tasks, CRM), highlighting action items, decisions, mentions, and project updates.
npx claudepluginhub tokoro7/skills --plugin update-issue-index