create-ra-skill

RA スキルジェネレーター

What This Does

リサーチアドミニストレーター（URA・研究支援者）が持つ業務知見を、対話的なヒアリングを通じて Claude Code のスキル定義（SKILL.md）に変換する。属人的なノウハウを構造化し、他の RA やエージェントが再利用できる形式にする。

Required Inputs

初回は以下の情報は不要。対話的にヒアリングして収集する。

ユーザーが最初に /create-ra-skill を実行した時点で、ヒアリングを開始する。

What It Produces

• skills/{skill-name}/SKILL.md — 完成したスキル定義ファイル
• スキルのテスト実行案（生成したスキルが意図通り動くかの確認方法）

手順

Phase 1: ヒアリング

以下の質問を順番に行い、スキルの素材を収集する。一度に全て聞くのではなく、回答に応じて深掘りする。

Q1. 業務の概要

どのようなRA業務についてスキルを作りたいですか？
（例: 科研費の予算執行管理、研究倫理審査の申請支援、産学連携のコーディネート 等）

Q2. 業務の目的

この業務の目的は何ですか？誰の、どんな課題を解決しますか？
（例: 「研究者が予算執行で迷わないように、ルールに基づいた判断を支援する」）

Q3. 入力情報

この業務を行うとき、最初に必要な情報は何ですか？
（例: 研究種目、予算額、購入したい物品の情報 等）

Q4. 具体的な手順

この業務を実際にどのような手順で進めますか？
ステップバイステップで教えてください。
初心者の RA でも再現できるレベルの具体性でお願いします。

Q5. 判断基準・ルール

手順の中で判断が必要な場面はありますか？
その判断基準やルールを教えてください。
（例: 「50万円以上の物品は設備備品に分類する」「年度末3月の発注は原則不可」）

Q6. よくあるミス・落とし穴

この業務で初心者がよくやるミスや、ベテランでも注意すべき落とし穴はありますか？

Q7. 成功基準

この業務がうまくいったと言える基準は何ですか？
（例: 「会計検査で指摘事項ゼロ」「申請書の不備による差し戻しゼロ」）

Q8. 参照情報

この業務で参照するマニュアル、規程、ウェブサイトはありますか？

Phase 2: スキル定義の生成

ヒアリング結果を以下のテンプレートに構造化する:

---
name: {kebab-case のスキル名}
description: {1行の説明}
user_invocable: true
---

# {スキルの日本語名}

## What This Does
{Q1 + Q2 の回答を統合した説明}

## Required Inputs
{Q3 の回答を構造化}
- **{入力1}**: {説明}
- **{入力2}**（任意）: {説明}

## What It Produces
{業務の成果物を列挙}
1. {成果物1}
2. {成果物2}

## 手順
{Q4 の回答をステップバイステップで構造化}

### 1. {ステップ名}
{具体的な手順}

### 2. {ステップ名}
{具体的な手順}
...

## 判断基準
{Q5 の回答を表やリストで構造化}

## よくあるミスと対策
{Q6 の回答を構造化}
| ミス | 対策 |
|------|------|
| {ミス1} | {対策1} |

## 品質基準
{Q7 の回答を基に品質基準を記述}

## 参照情報
{Q8 の回答をリンク付きで構造化}

## Available Tools
{業務内容に応じて適切なツールを記載}

Phase 3: レビューと修正

1. 生成したスキル定義をユーザーに提示する
2. 以下の観点でフィードバックを求める:
   • 手順に漏れはないか
   • 判断基準は正確か
   • 初心者が読んで実行できる具体性があるか
3. フィードバックを反映して修正する
4. 最終確認後、ファイルを保存する

Phase 4: ファイル保存

1. スキル名を kebab-case に変換（例: 「予算執行管理」→ budget-execution）
2. skills/{skill-name}/SKILL.md として保存
3. 保存先のパスをユーザーに通知

Phase 5: 次のステップの案内

スキルの保存後、以下を案内する:

スキルを保存しました: skills/{skill-name}/SKILL.md

このスキルを使うには:
  claude --add-dir ./skills/{skill-name}
  → /{skill-name} で実行できます

リポジトリに貢献するには:
  1. このリポジトリを fork
  2. skills/{skill-name}/ を追加
  3. Pull Request を作成
  詳しくは CONTRIBUTING.md を参照してください。

品質基準

• ヒアリングが一方的な質問にならず、対話的であること
• ユーザーの回答を正確に反映していること（勝手に情報を追加しない）
• 生成されたスキルが SKILL.md フォーマットに準拠していること
• 初心者の RA が読んで業務を遂行できるレベルの具体性があること
• 判断基準やルールが曖昧な場合、「確認が必要」と明記すること
• 生成後に必ずユーザーのレビューを挟むこと

Available Tools

• Read / Write: スキルファイルの読み書き
• Bash: ファイル操作、ディレクトリ作成