Claude-skill-registry commands-ja

変更要求: $ARGUMENTS

Think deeply ユーザーの変更意図を汲み取り、LLMが迷わない形で実装：

適用する9つの観点

1. コンテキスト圧迫 vs 実行精度 - 最小記述で最大精度
2. 重複排除 - スキルファイル内・スキルファイル間の一貫性
3. 責務の適切な集約 - 関連内容は1ファイルにまとめる（読み込み回数最小化）
4. 判断基準明確化 - 測定可能な基準
5. NG→推奨変換 - 推奨形式（背景：NG例を含む）
6. 表記統一 - 一貫した表現
7. 前提条件の明示化 - 暗黙前提を言語化
8. 記述順序最適化 - 冒頭：最重要、末尾：例外
9. スコープ境界明示 - 扱う/扱わない範囲

実行フロー

1. 変更要求の理解

未指定時の質問テンプレート：

1. どのスキルを変更しますか？
   例: typescript-rules / coding-standards / documentation-criteria

2. 変更種別を選択：
   a) 新基準追加（新しい基準を追加）
   b) 既存基準修正（曖昧な記述を明確化）
   c) 基準削除（不要になった基準を削除）

3. 具体的な変更内容：
   例：「any型の使用を禁止する基準を追加」
   例：「エラーハンドリングの基準を明確化」
   [ユーザー入力]

2. 変更設計案の作成

対象ファイル特定と現状確認：

# ツール選択基準（測定可能な判断）
if スキル名が明示されている:
  Read: .claude/skills/{スキル名}/SKILL.md を直接読み込み
else if スキル名の一部のみ判明:
  Glob: .claude/skills/*{キーワード}*/SKILL.md で探索
  Read: 特定したファイルの現状確認
else:
  Glob: .claude/skills/*/SKILL.md で全件確認
  ユーザーに対象スキル選択を確認

変更設計テンプレート：

【現状】
「エラーは適切に処理する」（曖昧：「適切」の基準不明）

【ユーザー要求の理解】
「エラーハンドリングを厳格化したい」→ 測定可能な基準を設定

【変更案】
「エラーハンドリング実装基準：
1. try-catch必須条件：
   - 外部API呼び出し（fetch, axios等）
   - ファイルI/O操作（fs.readFile等）
   - JSON.parse、parseInt等の変換処理
2. エラーログ必須項目：
   - error.name（エラー種別）
   - error.stack（発生箇所）
   - タイムスタンプ（ISO 8601形式）
3. ユーザー通知基準：
   - 技術詳細を含まない（NG例：スタックトレース表示）
   - 対処法を明示（推奨：「再度お試しください」）」

この設計で進めますか？ (y/n)

3. 3回見直しプロセス

第1回: 実行精度最大化の観点で追記【追記専用モード】

開始宣言: 「第1回：追記モードで実行。削除は一切行わない」

• 曖昧表現→測定可能基準に変換 例：「大きい」→「100行以上」「5ファイル以上」
• 暗黙前提→明示的条件として記載 例：「TypeScript環境で」「async関数内で」
• 例外ケース・エッジケースの定義 例：「null/undefinedの場合」「空配列の場合」 報告: 追記項目数をカウント（最低5項目）

第2回: 批判的修正で冗長性を削減【実修正モード】

開始宣言: 「第2回：批判的修正モードで実行。冗長と判断した箇所を実際に削除・統合」

修正作業：

1. 第1回の追記内容を批判的に検証
2. 以下の観点で実際に修正を実施：
   • 同一概念の重複 → 統合
   • 過度に詳細な説明 → 簡潔化
   • 他スキルとの重複 → 参照に置換
3. 修正前後の差分を記録（削除理由も明記）

報告フォーマット：

修正箇所数: X件
削除・統合した内容:
- [削除前]: 「詳細な記述」
  [削除後]: 「簡潔な記述」
  [理由]: 冗長性の排除

第3回: 差分評価による精度確保【復元判定モード】

開始宣言: 「第3回：差分評価モードで実行。第2回の修正を検証し、必要なら復元」

検証作業：

1. 第2回の各修正について評価：
   • この削除で実装時に迷う可能性があるか？
   • エッジケースの考慮が漏れていないか？
2. 精度低下リスクがある削除 → 復元
3. 妥当な削除 → 維持

最終確認質問（必須回答）： 「ユーザーの変更要求を正確に実装するための必要十分条件が揃っているか？」

報告: 復元項目数と最終的な削減率

4. 承認取得

変更前後の比較を提示し、ユーザー承認を取得。

5. 実装

1. 適切なツールで変更適用（ユーザー承認後）
2. git diffで変更内容を最終確認

3. /sync-skills

   実行提案

判断基準チェックリスト

• 「if-then」形式で表現可能（「～の場合は～する」）
• 数値・個数・状態で判定可能（主観的判断を排除）
• 関連内容は1ファイルに集約（読み込み回数最小化）
• 他スキルとの関係明記（依存・参照・委譲）
• NG例を背景情報として含む
• 前提条件が全て明示されている

削減パターン例

パターン	変換前	変換後
感情的表現	「必ずすべき」	「以下の場合に実行（背景：実行しないとビルドエラー）」
時間表現	「すぐに実行」	「エラー検出後、最初に実行」
暗黙前提	「エラーハンドリングを実装」	「TypeScript環境でasync関数のエラーハンドリング実装」
順序不明確	「以下を考慮：A、B、C」	「優先順：1.A（必須）、2.B（推奨）、3.C（任意）」
冗長説明	「型安全性を確保するため、型を定義し、型チェックを行い、型エラーを防ぐ」	「型安全性の確保（定義・チェック・エラー防止）」
スコープ曖昧	「テストを書く」	「単体テストを書く（E2Eテストはtypescript-testingスキル参照）」

出力例

=== 変更実装完了 ===

【ユーザー要求】
「TypeScriptのエラーハンドリング基準を厳格化したい」

【変更内容】
対象: .claude/skills/typescript-rules/SKILL.md
セクション: ## エラーハンドリング

変更前:
「エラーは適切に処理する」

変更後（3回見直しプロセス完了）:
「エラーハンドリング実装基準：
1. try-catchブロック必須条件：
   - 外部API呼び出し（fetch, axios等）
   - ファイルI/O操作（fs.readFile, fs.writeFile等）
   - JSON.parse、parseInt等の例外発生可能な処理
2. エラーログ必須項目：
   - error.name（エラー種別）
   - error.stack（発生箇所）
   - new Date().toISOString()（タイムスタンプ）
3. ユーザー向けメッセージ：
   - 技術詳細を含まない（NG例：スタックトレース表示）
   - 具体的な対処法を明示（推奨：「再度お試しください」）」

【改善指標】
- 判断基準明確度: 0% → 100%（全て測定可能）
- 曖昧表現: 1箇所 → 0箇所
- NG例を背景情報として含む

メタデータ同期のため /sync-skills を実行してください。

実行順序

1. ユーザー要求理解
2. 現状分析
3. 9観点を適用した変更設計
4. 3回見直しプロセス
5. ユーザー承認
6. 変更適用
7. sync-skills提案

スコープ: ユーザー変更要求の理解と精度最大化実装

エラーハンドリング

• スキル未発見: 利用可能なスキル一覧を表示
• 大規模変更検出: 変更量50%以上の場合、段階的実施を提案