Communityコーディング&開発github.com

saibi/gen_kor_subtitle

あいまいな開発リクエスト(複数行テキストまたはリクエストが記述されたファイル)を、英大文字3文字のIDが付いた体系的な計画ドキュメント plan/<ID>_plan_<エージェント>-<モデル>.md に変換します。

gen_kor_subtitle とは?

このスキルは、自然言語で書かれた曖昧な開発リクエストを、他のAIエージェントがそのまま実装できるほど詳細で構造化された計画ドキュメントに変換するツールです。開発者は複数行のテキストやファイルを渡すだけで、システムが自動的に英大文字3文字のID(例:FKS)を生成し、計画テンプレートに沿ったマークダウンファイルを plan/ ディレクトリに作成します。決定が必要な事項は選択肢と推奨案を提示して1つずつ確認・確定していくため、開発プロセスにおける曖昧さを排除します。また、不確実な技術的前提は短い実験で検証してから計画に反映するため、推測に基づく非現実的な計画を防止します。Claude Code, Cursor, Codex などの主要なAIエージェントプラットフォームで動作し、最終的には計画の実装段階(/m_impl)へスムーズに移行できるよう設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/saibi/gen_kor_subtitle/tree/HEAD/.agents/skills/m_plan

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

m_plan — リクエストを計画ドキュメントに変換

実装は行いません。他のエージェントがそのまま実装できるほど具体的な計画を作成することが目標です。

入力

  • スキルとともに受け取った引数が既存のファイルパスの場合、そのファイルの内容がリクエストです。それ以外の場合は、引数全体(複数行を含む)がリクエストです。
  • 引数が空の場合は、何を開発したいかを質問します。

手順

  1. 把握: リクエストを読み、関連する既存コード・ドキュメント(AGENTS.md、plan/README.md、再利用可能なコード)を確認します。
  2. IDの決定: 計画内容を最もよく表す英大文字3文字の略語(例:FKS = Foreign film Korean Subtitle)を決めます。plan/README.mdで重複を確認します。
  3. 前提の検証: 計画が依存している不確実な技術的前提は、簡易実験で確認します(CLIオプションの有無、外部サイト・APIへのアクセス可否、応答時間など)。確認結果と日付を計画に記載します。推測で計画しません。
  4. 作成: 以下のテンプレートで plan/<ID>_plan_<エージェント>-<モデル>.md を作成し(作成者の表記は AGENTS.md を参照)、plan/README.md のインデックステーブルに | <ID> | <計画名> | 計画中 | 行を追加します。
  5. 決定の確定: 決定が必要な事項を <ID>-Q1、<ID>-Q2… として記述し、ユーザーに一度に1つずつ質問します。
    • 各質問に選択肢を2〜3個提示し、推奨案には (推奨) とその理由を付けます。
    • ユーザーが選択肢にない回答をした場合は、実現可能か実験で確認した上で結果を伝え、反映します。
    • 回答を受けたら ✅ で確定を示し、本文の関連部分もその決定に合わせて修正します。
  6. 完了: すべての決定が確定したら、インデックスの状態を 計画確定(実装前) に変更し、コミットするかどうかを尋ねます。次のステップは /m_impl <ID> であることを案内します。

テンプレート (plan/<ID>_plan_<エージェント>-<モデル>.md)

# [<ID>] <計画名>

## 1. 目標
<何を、なぜ。範囲外の事項も明記>

## 2. 全体の流れ
<処理順序・優先順位。必要に応じて図>

## 3. ステップ別詳細
### 1) <ステップ>
- <具体的な方法、使用するコマンド/API/形式、失敗時の動作>

## 4. 共通モジュール
<複数のステップが共有する部分:入出力形式、外部ツール呼び出し、キャッシュ、エラー処理>

## 5. 実装構造
- ファイル構成、再利用する既存コード、依存関係の原則、設定方法
- CLI/使用方法の草案

## 6. 決定事項
- **<ID>-Q1** <質問> — 選択肢 …(確定した場合は `✅ <決定内容>`)

## 7. マイルストーン
| # | 内容 | 完了基準 |
| :--- | :--- | :--- |
| <ID>-M1 | … | <検証可能な基準> |

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル