← ClaudeAtlas

update-readme-indexlisted

takumi-ai-stacks リポジトリの README.md にある「skill 一覧」「rules 一覧」テーブルを、 skills/ や rules/ の実体に合わせて追記・更新する。 ユーザーが「skill一覧に追記して」「ルール一覧を更新して」「新しいスキルをREADMEに反映して」 「skill/rulesの一覧を最新化して」等、README の skill一覧・rules一覧テーブルへの反映を 明示的に依頼したとき、または skills/*, rules/* にファイルを追加・変更した後にその反映を 頼まれたときに使用する。skills/ や rules/ と無関係な README の変更(利用方法セクションの 加筆など)には使用しない。
takumi314/takumi-ai-stacks · ★ 0 · AI & Automation · score 55
Install: claude install-skill takumi314/takumi-ai-stacks
# README skill/rules 一覧 更新スキル ## 目的 このリポジトリの README.md には、`skills/` 配下の各 skill と `rules/` 配下の各 rule を一覧化した テーブルがある。skill や rule を追加・更新したのに README への反映を忘れると、他のエンジニアが 一覧から実体を辿れなくなる。このスキルは、skills/ と rules/ の実体(SKILL.md の frontmatter や rule ファイルの内容)から一覧テーブルの行を機械的に組み立て、README.md に反映する。 ## 対象範囲 - 追加・更新された skill / rule を README のテーブルに反映すること(行の追加・更新)が主目的。 - skill / rule の削除に伴う行削除は対象外。ユーザーから明示的に削除を依頼された場合のみ、その指示 に従って該当行を削除してよい。 - README の一覧テーブル以外の記述(「利用方法」「格納ルール」等のセクション)は変更しない。 - `skills/`, `rules/` 以外のディレクトリ・ファイル(例: `docs/`, `.github/` 等)の追加・変更は 対象外。このスキルはそれらを検知・反映する仕組みを持たない。誤って呼ばれた場合は、手順1の とおり「対象が見つからない」旨を報告し、README には一切手を加えない。 ## 手順 ### 1. 対象を特定する - `git status --short skills/ rules/` と `git diff -- skills/ rules/` を確認し、追加・変更された ファイルを特定する。 - ユーザーが対象の skill/rule 名を明示した場合はそれを優先する。 - 特に指定がなく「一覧を最新化して」のような依頼の場合は、`skills/*/SKILL.md` と `rules/*.md` の 全件を洗い出し、README 側のテーブルと突き合わせて過不足(未掲載・内容の乖離)がないか確認する。 - `skills/`, `rules/` に該当する変更が見つからない場合(他のディレクトリ・ファイルのみが変更されて いる場合を含む)は、その旨をユーザーに報告して終了する。README.md には一切変更を加えない。 「一覧テーブルは既に最新です」と「そもそも対象の変更が見当たりません」は区別して伝える。 ### 2. skill の情報を抽出する 各 `skills/<name>/SKILL.md` の frontmatter(`name`, `description`)を読む。 `description` は通常「①何をするか」と「②どんな発話・状況で使うか」の2つの要素で構成されている (`skills/auto-commit-msg/SKILL.md` を参照)。これを以下のように2列に振り分ける: - **説明**列:①に相当する一文。「〜する」で終わる簡潔な要約にする。 - **利用場面**列:②に相当する一文。「〜と言ったとき」「〜な場合に使用する」に該当する部分を使い、 ユーザー発話の引用(「」で囲まれた部分)があればできるだけそのまま残す。 description の文が綺麗に2分割できない場合は、無理に機械的に割らず、趣旨を保ったまま自然な日本語で 要約してよい。 ### 3. rule の情