promote

promote skillの概要

promoteができること

promote skillは、Claudeがauto-memoryで繰り返し学習し、実際に有効だと確認できた振る舞いを、明示的なプロジェクトルールへ引き上げるためのスキルです。有用なパターンをMEMORY.mdに埋もれさせたままにせず、CLAUDE.md、.claude/rules/<topic>.md、またはグローバルなClaude instruction fileへ移し、今後のセッションでも一貫して守られるようにします。

自己改善型Claudeワークフローに向いているケース

promoteは、チームがすでにClaudeへ修正内容、好み、繰り返し出てくるプロジェクト慣習を学習させていて、その中の一部を恒久的なルールにしたい場合に使います。特に、MEMORY.mdが観察事項を記録し、rule filesがエージェントに確実に従わせる内容を定義するContext Engineering構成で役立ちます。

良い例は、「このrepoでは常にpnpmを使う」「API handlersは入力を検証する必要がある」「billing codeのテストではこれらのfixturesが必要」といったものです。一方で、一度きりの好み、結論が出ていない議論、実際にうまく機能したことを確認していないルールは不向きです。

このpromote skillが役立つ理由

このskillは、単なるコピー＆ペースト用のリマインダーではありません。パターンを明確にし、根拠となるmemory entriesを探し、適切なtarget fileを選び、実行可能なルールとして書き、元のmemoryにはpromotion noteを残す、という判断の流れを提供します。重要なのは、markdownを編集すること自体ではありません。難しいのは、そのmemoryを恒久的に強制すべきか、そしてどこにルールとして置くべきかを判断することです。

promote skillの使い方

promoteのインストールとrepo確認の進め方

GitHub skill collectionから次のコマンドでskillをインストールします。

npx skills add alirezarezvani/claude-skills --skill promote

まずSKILL.mdを読みます。このrepository pathでは現在、promoteのワークフローが単一ファイルで提供されているため、確認すべきhelper scripts、references、rule templatesはありません。導入はシンプルですが、重要なrepoで使う前に、command examplesとtarget-selection tableを慎重に確認してください。

実務でpromoteを呼び出す方法

想定されているtriggerは/si:promoteで、その後に恒久化したいパターンを続けます。

• /si:promote use pnpm instead of npm
• /si:promote API handlers need validation --target rules/api.md
• /si:promote tests for auth changes must include session expiry cases --target rules/testing.md --paths "src/auth/**/*.ts"

このskillは、まずどの振る舞いを指しているのかを確認します。依頼が曖昧な場合は、たとえばそのルールがglobalに適用されるのか、特定のpathsだけに適用されるのかなど、確認質問を1つ行うべきです。その後、~/.claude/projects/.../memory/MEMORY.md配下にあるプロジェクトのClaude auto-memory fileから関連entryを検索し、一致した内容を表示して、そのmemoryがpromotionの根拠になるかを確認します。

粗い目的を強いpromptに変える

弱いpromptは「promote our testing preference」のようなものです。より良いpromoteの使い方は、振る舞い、根拠、scope、分かっていればtargetを含めます。

/si:promote "When changing billing code, add regression tests for failed payment and retry paths" --target rules/testing.md --paths "src/billing/**/*.ts"

このほうが、skillが曖昧な好みではなく、強制可能なルールを書けます。次の要素を含めてください。

• Claudeが従うべき具体的な振る舞い
• プロジェクト全体、特定のfile types、またはすべてのprojectsのどれに適用するか
• ルールにscopeがある場合のexample paths
• そのパターンが有用だと示したmemory phraseまたはincident

ルールをmergeする前の推奨ワークフロー

promoteがルールをdraftまたはeditしたら、production configurationと同じつもりでreviewします。指示が短く、検証可能で、根拠が示す範囲より広くなっていないかを確認してください。プロジェクト全体の振る舞いであれば、通常はCLAUDE.mdが適しています。範囲が狭い振る舞いなら、path scopeを付けた.claude/rules/<topic>.mdを優先します。repoをまたぐ個人的な慣習には、そのパターンが本当に普遍的な場合に限って、グローバルなClaude instruction fileを使ってください。

promote skill FAQ

promoteはContext Engineering向けか、一般的なprompting向けか

Promoteは、観察された振る舞いから永続的なinstructionへ進む道筋を形式化するため、Context Engineeringで特に価値があります。一般的なpromptでも、Claudeに1セッションだけ何かを覚えさせることはできます。promoteは、その学びをrepoのoperating contextの一部にすべきかどうかを判断する助けになります。

promoteを使うべきでない場面

promoteは、未検証のアイデア、一時的なworkaround、チームの規範と衝突する個人的な好み、application code、tests、linters、CIに置くべきinstructionsには使わないでください。ルールはagent behaviorを導くときに有用です。一方で、実行可能な強制手段の代わりになってしまうとリスクがあります。

手動でCLAUDE.mdを編集するのと何が違うのか

手動編集でも対応は可能ですが、根拠やscopeの確認が抜けがちです。promote skillは、memoryを見つけ、意図した振る舞いを確認し、適切なdestinationを選び、memoryがpromotedされた履歴を残す、という再現可能なプロセスを追加します。これによりrule sprawlを抑え、将来のmaintainersがそのinstructionの存在理由を理解しやすくなります。

promoteは初心者にも使いやすいか

はい。ただし、Claude project memoryとrule filesがどこにあるかをユーザーが理解している場合です。初心者は、プロジェクト全体に適用される明確なパターンを1つ選び、--target claude.mdを使うところから始めるとよいでしょう。.claude/rules/の慣習に慣れるまでは、scoped path rulesは避けるのがおすすめです。

promote skillを改善する方法

より良い根拠でpromoteの結果を改善する

promote skillは、source memoryが具体的であるほどよく機能します。呼び出す前に、ルールが必要だと示す正確なmemory entry、correction、または繰り返し発生したfailureを集めてください。「Claude keeps using npm」よりも、「In three sessions Claude ran npm commands, but this repo uses pnpm and has no package-lock.json」のほうが強い根拠になります。

よくあるpromotionの失敗を避ける

最も多い失敗はover-promotingです。狭い観察結果をglobal commandにしてしまうケースです。もう一つは、「write better tests」のように、良さそうに見えても実行可能ではないルールを書くことです。より良いルールは、trigger、required action、scopeを明示します。たとえば「For src/api/**/*.ts, validate request bodies before calling service functions.」のように書きます。

最初に生成されたルールの後で反復する

最初のpromote出力を得たら、そのルールが広すぎないか、曖昧すぎないか、どこかに重複していないかを確認します。そのうえで refine してください。便利なfollow-up promptsには次のようなものがあります。

• “Make this rule enforceable in one paragraph.”
• “Narrow this to only API route files.”
• “Add one example and one non-example.”
• “Check whether this belongs in CLAUDE.md or .claude/rules/testing.md.”

ルール体系を健全に保つ

良いpromote guideは、rule layerがノイズだらけになるのを防ぐべきです。promoted rulesは定期的に見直し、衝突、古くなった慣習、toolingへ移すべきinstructionsがないか確認します。最良のpromoteの成果は、markdownが増えることではありません。Claudeが適切なscopeで、持続的に使えるcontextを受け取ることで、同じ修正を繰り返さずに済むようになることです。