Improve
パス: ${CLAUDE_SKILL_DIR} はこの SKILL.md が置かれているフォルダ、${CLAUDE_SKILL_DIR}/../.. はその2階層上のエディターの .claude/ フォルダを示します。
ユーザーへの質問はすべて質問ボックスに入力してください。AskUserQuestion ツールを呼び出します(2~4個の選択肢を用意し、推奨するものを最初に配置)。そのツールがないエージェントの場合のみ、番号付きの質問をテキストで行ってください。
このスキルはリポジトリのチェックアウト内で、リポジトリのメンテナーが実行するものです。ここでの修正は、全ユーザーが次回更新時に受け取ることができます。S="${CLAUDE_SKILL_DIR}/scripts"。スクリプトはMacとLinuxでは python3 で、Windowsでは py で実行してください。
0. 誰が実行しているか
python3 "$S/improve.py" mode
maintainer: AI_EDITOR_MAINTAINER=1 が設定されたリポジトリのgitチェックアウト内でのみ。ステップ1に進んでください。
user: エディター自身のファイルは更新のたびに置き換えられるため、決して編集しないでください(SKILL.md、リファレンス、スクリプト、PRINCIPLES.mdは対象外)。以下に従って収集・選択し、承認された各項目を、更新によって変更されないユーザー自身のレイヤーに保存します(リポジトリ内の docs/customise.md を参照):設定は taste.py add ... --set を使用、単語ルールは python3 "${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py" rule "<rule>" を使用、キャプションの見た目は custom/captions/<name>.json と taste.py set captions.preset <name> を使用、テンプレートのデフォルトは custom/templates/<type>.json を使用します。その後 taste.py suggest を実行して、メンテナーが全員のために修正できるように提案してください。ここで終了します。
1. 収集
python3 "$S/improve.py" collect [--edits D] [--no-gh]
各行が1つのルールを表し、最も多く繰り返されたものが先頭に来ます:出現回数、発生元(suggestion、taste regression、preview correction、review note、GitHub issue)、所有者の名前、最大3つの例。複数のユーザーから報告されたルール、または適用後に再度報告されたルールが優先されます。
2. 選択
キューの先頭を表示し、質問ボックスでどの項目を今修正するか尋ねます(複数選択可。最も繰り返されたものを最初に、推奨)。各項目について、不明な場合はさらに尋ねます:すべてのユーザー(推奨)/ 一部のクリエイターのスタイルのみ(ルールではなく style.json フィールドに属する)/ 修正不要(クローズ)。
3. 各項目を以下の順序で修正
- ルール。
${CLAUDE_SKILL_DIR}/../../PRINCIPLES.mdの適切な見出しの下に1行。どこで強制されるかを明記し、所有するSKILL.mdまたはリファレンスにも同じルールを追加。一般的で、決して1つのビデオについてではありません:「ズームは少なくとも0.5秒かけてイーズアウトする」はOK、「0:12のズームが急だった」はNG。 - 強制。 誰も覚えていなくてもルールが守られる最小のコード:チェック(
check.py、quality.py、product.py check、ai_tells.py)でのFAIL、それを破るスクリプトでの拒否(gates.py)、生成不可能なデフォルト、またはリポジトリルールのためのtests/check_plugins.pyの1行。新しいチェックを追加するよりも、既存のチェックを強化することを優先。 - テスト。 そのスクリプトの
demo()(またはtests/)内のアサーション。小さな合成例から構築。修正前に実行して失敗を確認し、修正後に実行して成功を確認。エージェントのみが従えるルール(質問、説明)には、代わりにevals/に評価ケースを追加:prompt.mdとtool_usedまたはllmグレーダー。 - 記録。
docs/feedback-matrix.md:ルール、記載場所、強制方法、テスト内容。
4. すべて実行
python3 tests/check_plugins.py
python3 .claude/lib/ai_editor/okf.py check
続けて tests/demos.sh(全スクリプトのデモ)、node tests/test_record.mjs、レンダラーが設定されていれば tests/smoke.py と tests/golden.py。すべてグリーンになってから引き継ぐこと。コミットはしないでください。メンテナーが差分を確認してコミットします。
修正が完了したGitHub Issueについては、修正の1行要約をコメントしてクローズする提案をしても構いません(gh issue close <n> --comment "...")。ただし、必ず事前に質問してください。
絶対にしてはいけないこと
- ユーザーの taste.md、taste.json、rules.json、suggestions.jsonl を編集しないでください。それらはユーザーのものです。
- 個人データをリポジトリに入れないでください。フィードバックからの名前、ハンドル、メールアドレス、ファイル名、映像は一切含めてはいけません。一般的なルールと合成例を記述してください。
tests/check_plugins.pyは既知の個人名を検出してFAILします。すべての例をリポジトリに入れる前に確認してください。 - メモだけでループを閉じてはいけません。強制もテストもないルールは完了ではありません。
ファイル
scripts/improve.py:mode、collect、demo。読み取り専用。${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py: ユーザーの<library>/custom/フォルダ(ユーザーモードはここに書き込みます)。${CLAUDE_SKILL_DIR}/../../skills/taste/scripts/taste.py:suggestとissueがユーザー側に書き込む場所。