skill-looplisted
Install: claude install-skill aliksir/lesson-skill-loop
# skill-loop — 教訓⇔スキル フィードバックループ
教訓ファイル(lessons/*.md)のタグパターンを分析し、スキル化候補の提案・既存スキルとの差分検出・スキル健全性チェックを行う。
## 対応環境
Claude Code と Claude Cowork の両方で動作する。
- **Claude Code(Bashあり)**: Node.jsスクリプトで高速実行(推奨)
- **Claude Cowork(Bashなし)**: Claudeの組み込みツール(Glob/Read/Grep)で同等の分析を実行
> **Cowork利用時の注意**: Coworkではプロジェクト内のファイルのみアクセス可能。教訓ファイル(`lessons/*.md`)がプロジェクトリポジトリ内に存在する場合のみ使用できる。ローカルの `~/.claude/` 配下にのみ教訓がある場合は、CLI版(`npx claude-skill-loop`)を使用すること。
## モード判定
引数 `$ARGUMENTS` からモードを判定���る:
| 引数 | モード | 内容 |
|------|--------|------|
| なし / `analyze` | **analyze** | タグ分析+スキル化候補提案 |
| `sync` / `--sync` | **sync** | 既存スキルとの差分分析 |
| `health` / `--health` | **health** | スキル健全性チェック |
| `map` / `--map` | **map** | スキル⇔教訓トレーサビリティマップ |
| `all` / `--all` | **all** | 全モード実行 |
引数の残りをlessonsディレクトリのパスとして扱う。パス指定がなければデフォルトパスを使用。
## 実行方法の選択
**まずBashツールが利用可能か確認する。**
### Bashが使える場合(Claude Code)
Node.jsスクリプトで実行する。以下の優先順で実行コマンドを決定:
1. プラグインとしてインストール済みの場合:
```
node ${CLAUDE_PLUGIN_ROOT}/skill-loop.js [オプション] [lessons_dir]
```
2. npxで実行:
```
npx claude-skill-loop [オプション] [lessons_dir]
```
実行結果をそのままユーザーに表示して終了。
### Bashが使えない場合(Claude Cowork)
以下の「Coworkモード手順」に従い、Claudeの組み込みツールで分析を実行する。
---
## Coworkモード手順
### 共通: 教訓ファイルの特定
1. lessonsディレクトリを特定する(優先順):
- 引数で指定されたパス
- カレントディレクトリの `lessons/` フォルダ
- `memory/lessons/` フォルダ
2. Globツールで `{lessonsDir}/*.md` を検索
3. ファイルが0件なら「教訓ファイルが見つかりません」と報告して終了
### 共通: スキルディレクトリの特定
1. `~/.claude/skills/` をスキルディレクトリとする
2. Globツールで `~/.claude/skill