--- description: ユーザーのスキル変更要求を最適化パターン評価付きで実装 --- **コマンドコンテキスト**: スキルファイルの変更要求を理解し、skill-creator(modificationモード)による品質評価付き実装ワークフロー。 変更要求: $ARGUMENTS ## 実行プロセス 以下のステップをTaskCreateで登録し、順番に進行する。 ### Step 1: 変更要求の理解 未指定時はAskUserQuestionで確認: - どのスキルを変更するか(例: typescript-rules / coding-standards) - 変更種別: 新基準追加 / 既存基準修正 / 基準削除 - 具体的な変更内容 対象ファイル特定: - スキル名が明示 → Read: `.claude/skills/{スキル名}/SKILL.md`(`~/.claude/skills/`も確認) - 部分的に判明 → Glob: `.claude/skills/*{キーワード}*/SKILL.md`, `~/.claude/skills/*{キーワード}*/SKILL.md` - 不明 → Glob: `.claude/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` で全件確認 → ユーザーに選択 ### Step 2: ユーザーフレーズの収集(任意) チームがこの作業を依頼する際に実際に使うフレーズを確認: - 変更がdescriptionやスコープに影響する場合は必須 - 軽微な基準修正の場合は省略可 ### Step 3: 変更設計案の作成 現状と変更案のbefore/afterを提示: ``` 【現状】 "エラーは適切に処理する"(曖昧:「適切」の基準不明) 【変更案】 "エラーハンドリング実装基準: 1. try-catch必須条件:外部API呼び出し、ファイルI/O、JSON.parse等 2. エラーログ必須項目:error.name、error.stack、タイムスタンプ" この設計で進めますか? (y/n) ``` **設計チェックリスト**: skill-optimizationスキルの9つの編集原則に照らして設計案を評価。重点項目: - コンテキスト効率: 追加する全文がLLMの判断に寄与するか - 測定可能性: 全基準がif-then形式または具体的閾値か - 重複排除: 他スキルファイルとの重複がないか - スコープ境界: 変更内容がこのスキルの責務範囲内か ### Step 4: skill-creatorによる変更実行 skill-creatorエージェントをAgent toolでmodificationモードとして起動: ``` subagent_type: skill-creator prompt: | Mode: modification Skill name: {対象スキル名} Existing content: {現在のSKILL.md全文} Modification request: {Step 3で承認された変更内容} ``` skill-creatorが返すchangesSummaryを確認し、変更内容が意図通りか検証。 ### Step 5: 品質レビュー skill-reviewerエージェントをAgent toolで起動: - skill-creatorの出力を組み立てたSKILL.md全文を渡す - レビューモード: `modification` **レビュー結果の処理:** - グレードAまたはB: Step 6へ進行 - グレードC: skill-creatorをreviewerのactionItemsとpatternIssues付きで再起動し修正(最大2回) - 変更スコープ外の問題を検出: 別の改善機会としてユーザーに報告 ### Step 6: 承認取得と実装 1. 変更前後の比較をユーザーに提示し承認を取得 2. skill-reviewerのグレードと残存する修正提案を提示 3. skill-creatorのchangesSummaryを提示 4. 意図の整合性を確認: 「この変更は当初の要求を正しく反映していますか?」 5. 適切なツールで変更適用 6. git diffで変更内容を最終確認 7. 変更スコープ外の問題があれば、任意の改善事項として提示 8. `/sync-skills`実行を提案 ## 完了条件 - [ ] 対象スキルを特定し現状を把握した - [ ] skill-optimizationの編集原則に照らして設計案をレビューした - [ ] skill-creator(modificationモード)で変更を実行した - [ ] skill-reviewerがグレードAまたはBを返却した - [ ] ユーザー承認を取得した - [ ] 変更を適用しgit diffで確認した - [ ] /sync-skills実行を提案した ## エラーハンドリング | エラー | アクション | |--------|-----------| | スキル未発見 | 利用可能なスキル一覧を表示 | | 大規模変更検出(ファイルの50%以上) | 段階的実施を提案 | | 他スキルとの責務重複 | 責務境界を確認しユーザーに判断を委ねる | | 2回のレビューでもグレードC | 変更内容と問題リストを提示し、ユーザーに判断を委ねる | | reviewerが退行を検出 | 退行原因の変更を取り消し、skill-creatorを再起動 | **スコープ**: ユーザーの変更要求理解と品質評価付き最適化実装。変更実行はskill-creator(modificationモード)に委譲。品質評価はskill-reviewerエージェントに委譲。メタデータ同期は/sync-skills連携。