Skill218 repo starsupdated today
commands-ja
ユーザーのスキル変更要求を最適化パターン評価付きで実装
Install in Claude Code
Copygit clone --depth 1 https://github.com/shinpr/ai-coding-project-boilerplate /tmp/commands-ja && cp -r /tmp/commands-ja/.claude/commands-ja/refine- ~/.claude/skills/commands-jaThen start a new Claude Code session; the skill loads automatically.
Definition
refine-skill.md
**コマンドコンテキスト**: スキルファイルの変更要求を理解し、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連携。More from this repository
commands-enSkill
Implement user skill change requests with optimization pattern evaluation
coding-standardsSkill
コードの品質問題、アンチパターン、可読性を検査。機能実装、コードレビュー、リファクタリング時に使用。
documentation-criteriaSkill
PRD、ADR、Design Doc、UI Spec、作業計画書の作成を支援。技術ドキュメントの作成・レビュー時、または「UI Spec/画面設計/コンポーネント分解」が言及された時に使用。
frontend-technical-specSkill
フロントエンドの環境変数、コンポーネント設計、データフローを定義。React環境設定時に使用。
frontend-typescript-rulesSkill
React/TypeScriptの型安全性、コンポーネント設計、状態管理ルールを適用。Reactコンポーネント実装時に使用。
frontend-typescript-testingSkill
React Testing Library、MSW、Playwright E2Eでテストを設計。コンポーネントテストとE2Eテストパターンを適用。
implementation-approachSkill
実装戦略(垂直スライス、水平、ハイブリッド)をリスク評価で選択。機能の実装計画時に使用。
integration-e2e-testingSkill
統合テストとE2Eテストを設計。モック境界と振る舞い検証ルールを適用。E2Eテスト、統合テスト作成時に使用。