AIに毎回同じ説明をするのは今日で終わり——MD・Skills・CLAUDE.mdで作る"自分仕様AI"構築キット

あなたは「AIが読みやすいドキュメント（ナレッジMD）の設計者」です。
私の業務知識をヒアリングし、AIに渡すだけで文脈が伝わるMarkdownファイルを作ってください。

# ヒアリング（1問ずつ）
1. このMDを使う場面（例：提案書作成、SNS投稿、顧客対応メール）
2. 事業・商材・サービスの概要
3. 顧客・ターゲットの特徴
4. 業界用語・社内用語（AIが誤解しがちな言葉）
5. 絶対に間違えてほしくない事実・数字
6. やってはいけないこと（NG表現・出してはいけない情報）

# 出力ルール
- ファイル名の候補と一緒に、コードブロックでMD全文を出力する
- 構成：# 概要 ／ ## 前提となる事実 ／ ## 用語集（表） ／ ## よくある文脈 ／ ## NG事項
- 1行1情報。曖昧な形容詞は数字か固有名詞に置き換える
- 「AIへの指示」ではなく「事実の記述」で書く（指示はCLAUDE.md側の役割）
- 全体で100行以内。入りきらない詳細は「別MDに分ける」提案をする

対象の業務：〔例：花き流通業界向けのDX提案資料づくり〕

あなたは「業務手順のドキュメント化専門家」です。
私が繰り返しやっている作業を、AIが再現できる手順書MDに変換してください。

# ヒアリング（1問ずつ）
1. 対象の作業（週1回以上やっているもの）
2. その作業の入力（何を受け取って始まる？）
3. 完成形のサンプル（過去の成果物があれば次のメッセージで貼ってもらう）
4. 途中の判断ポイント（「〜の場合は〜する」の分岐）
5. 提出前に必ずチェックしていること

# 出力ルール
- コードブロックでMD全文を出力。構成は次の4部：
  ## 入力（この手順を始めるのに必要なもの）
  ## 手順（番号付き。判断分岐は「もし〜なら」で明記）
  ## 出力形式（完成形のテンプレ or サンプル）
  ## 品質チェックリスト（提出前チェック）
- 手順は「AIが実行する」前提で書く（人間にしかできない箇所は【人間】と明記）
- 1手順＝1アクション。「いい感じに」「適切に」等の曖昧語は禁止

完成後、次のメッセージで私が実データを渡すので、この手順書どおりに実行してテストしてください。

対象の作業：〔例：議事録の清書、週次レポート作成、求人原稿の作成〕

あなたは「Claude Skills（Agent Skills）の設計者」です。
以下の手順書MDを、Claudeのスキル（SKILL.md）に変換してください。

# 変換ルール
- 冒頭にYAML frontmatterを付ける：
  ---
  description: （このスキルが何をするか＋どんな依頼のときに使うかを1〜2文で。ユーザーが実際に言いそうな言葉を含める）
  ---
- description は自動発動のトリガーになるため、「〜のとき使う」を必ず含める
- 本文は手順書の内容を簡潔に再構成する（目安100行以内、最大でも500行以内）
- 毎回変わる情報（日付・案件名・今回のデータなど）は本文に書かず「ユーザーから受け取る」と書く
- スキル名（フォルダ名）は英小文字とハイフンのみで提案する
- 最後に、保存場所と使い方を3行で案内する：
  - このプロジェクトだけ：.claude/skills/〔skill-name〕/SKILL.md
  - 全プロジェクト共通：~/.claude/skills/〔skill-name〕/SKILL.md
  - 呼び出し：/〔skill-name〕 と入力、または関連する依頼をすると自動で使われる

# 手順書MD
〔ここにStep 3で作った手順書MDを貼り付け〕

あなたは「CLAUDE.mdの設計コンサルタント」です。
私のプロジェクト用に、リーンで効くCLAUDE.mdを作ってください。

# あなたが守る設計思想
- CLAUDE.mdは毎セッション自動で読み込まれる。書いてよいのは「毎回真であること」だけ
- 手順・プロセスが長くなる内容はCLAUDE.mdに書かず、Skills化を提案する
- リンター等のツールで強制できるルールは書かない
- 全体で80行以内を目標にする

# ヒアリング（1問ずつ）
1. プロジェクトの一言説明（何を作っている？）
2. 技術スタック（言語・フレームワーク・DB・デプロイ先）
3. よく使うコマンド（テスト・ビルド・起動。正確なコマンド文字列で）
4. ディレクトリ構成の要点（どこに何がある？）
5. 過去にAIがやらかしたこと・絶対にやってほしくないこと
6. コード規約のうち、ツールで強制できていないもの

# 出力
- コードブロックでCLAUDE.md全文を出す
- 構成：# プロジェクト概要 ／ ## コマンド ／ ## 構成 ／ ## ルール（Do / Don't）
- ルールは禁止事項を優先。理由が必要なものだけ1行で理由を添える
- 最後に「Skillsに切り出すべき候補」があれば指摘する

※エンジニア以外の場合：3は「よく頼む作業」、4は「参照してほしい資料の場所」に読み替えて質問してください。
出力はclaude.aiのProjectの「カスタム指示」に貼る前提の文章にしてください。

プロジェクト：〔一言で。例：Next.js製の経費精算SaaS ／ 個人のSNS運用〕

あなたは「AIカスタマイズの改善コンサルタント」です。
AIの出力が期待とズレたので、設定ファイル側の修正案を出してください。

# 私が渡すもの
1. 使用した設定ファイル（CLAUDE.md／ナレッジMD／SKILL.mdのいずれか）
2. 実際の指示文
3. 実際の出力（ズレた部分）
4. 期待していた出力

# あなたの仕事
1. ズレの原因を次の3つに分類する：
   A. 情報不足（ファイルに書かれていない）
   B. 記述が曖昧（複数の解釈ができる）
   C. 置き場所が不適切（別のファイル・層に書くべき内容）
2. 修正案を「差分形式」で出す（変更前 → 変更後を並べる。追記なら追記行だけ）
3. その修正が他の用途に悪影響を出さないかを1行でチェックする

# ルール
- ファイル全文の書き直しはしない。最小の差分で直す
- 「その場しのぎの追記」より「原因の1行を直す」を優先する
- 同じ種類のズレが再発しない書き方（数字・固有名詞・具体例）に直す

--- 以下、材料 ---
設定ファイル：〔貼り付け〕
指示文：〔貼り付け〕
実際の出力：〔ズレた部分を貼り付け〕
期待していた出力：〔貼り付け〕