manage-skill

name	manage-skill
description	フィードバックや学びから skill を新規作成・更新する手順。同種の指摘が2回以上出たとき、手順を skill 化したいとき、既存 skill を改訂/整理したいときに使う

skill の作成・更新

レビューや作業で得た学びを再発防止の仕組みへ昇格させる（CLAUDE.md の「フィードバックの昇格」を実行する手順）。

1. 昇格するか判断する

• 判定基準は「同種の指摘が2回以上出たか」。一度きりは skill 化しない。
• 昇格先を選ぶ:
  • 恒久ルール（常に効かせたい短い規範）→ CLAUDE.md に1行追記する。
  • 多段手順・固有知見（作業時に参照するチェックリスト）→ skill を新規作成 or 既存を更新する（本手順）。
  • 機械検知可能（形式で検出できる）→ golangci-lint のルール有効化 / カスタム linter 化する。機械化できたら skill から外す。

2. 新規作成するか既存に足すか

• 既存 skill（ls .claude/skills/）に近い主題があれば、そこにチェック項目を追加する（skill を増やしすぎない）。
• 独立した主題なら新規作成する。

3. skill を書く

1. .claude/skills/<name>/SKILL.md を作る。<name> は kebab-case。
2. フロントマターを付ける:

   ---
   name: <name>
   description: <何をする skill か + いつ使うか>
   ---
   

   • description はいつ使うかを明記する（自動で呼び出される判断材料になる）。例:「〜するときに使う」。
3. 本文は簡潔な手順・チェックリストにする。ロジック・説明は日本語。
4. CLAUDE.md の「skill（詳細手順・知見）」インデックスに1行追加する。

4. 更新・整理する

• 指摘に対応するチェック項目を該当 skill に追加する。
• 肥大化を防ぐ: 誤検知・冗長な項目は削る。make check や linter で担保できるようになった項目は skill から除去して二重管理を避ける。

参照

• 昇格の方針は CLAUDE.md「フィードバックの昇格」。