mcpField
T
task-generator

task-generator

github.com/nextstage-brasil開発041 回インストール5 日前に更新
リポジトリ

task-generator について

機能の原子的な作業単位を、エンジニアやコーディングエージェント向けの詳細なMarkdownタスクに変換するスキルです。要件、依存関係、実装指針、検証基準に沿って、バックエンド、フロントエンド、インフラの作業を扱います。

主な機能

  1. 01番号付きMarkdownタスクの生成
  2. 02バックエンド、フロントエンド、インフラに対応
  3. 03アーキテクチャとハーネスのルールを適用
  4. 04レイヤー別の実装指針を記載
  5. 05依存関係と検証基準を記録

活用シーン

  1. 01機能を実装可能なタスク単位に分割
  2. 02data-testid契約を含むフロントエンドタスクの作成
  3. 03API依存関係に基づくバックエンドとフロントエンドの順序付け
  4. 04実装指示と検証要件の文書化

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nextstage-brasil/skills --skill task-generator

インストール後、Claude Code で/task-generatorを入力して読み込まれたか確認します。

同梱ファイルevals/evals.jsonreferences/task-schema.md

詳細

タスクジェネレーター

Feature のアトミックスライスを、エンジニアやコーディングエージェント向けの詳細な task-NNN-slug.md に変換します。

ハーネスの検出

../nextstage-harness/references/harness-discovery.md を参照してください。{harness_root}/rules/*.md からルールを読み込みます。最初に architecture-rules.md を読んでください。レガシー対応として、{harness_root} が存在しない場合に限り .cursor/rules/*.mdc を使用します。requirements.md は厳密に読み、テーブルやエンドポイントを独自に作成しないでください。

スコープ

  • レイヤー: Backend、Frontend、Infrastructure
  • このスキルの対象外: E2E → e2e-test-generator、Backend のユニットテスト → unit-test-task-generator

基本原則

1 行だけの要約は不可です。実装担当者が、何をすべきか、どこで(想定されるパス)、どのスタックやルールを適用するか、検証基準を把握できるようにしてください。詳細セクションで要約をそのまま繰り返さないでください。

入力

  • アトミックなタスクの説明(オーケストレーターから)
  • レイヤーの種類:Backend | Frontend | Infra
  • {product_root}/docs/versions/{version_san}/requirements.md
  • タスク番号 NNN と依存タスク

依存関係

  • FK の親を子より先に実装します。タスクの順序はマイグレーション/API の順序を反映します
  • フロントエンドが API を利用する場合、バックエンドのタスクを先に実施します
  • ファイル全体のテンプレートについては references/task-schema.md を参照してください

分類

  • Error — 既存機能のバグ
  • Improvement — 既存機能の動作変更
  • Implementation — 新機能

フロントエンドの追加事項

タスクが UI に関わる場合:

  • data-testid の規約 — ケバブケースを使用し、btn-、input-、form- などの接頭辞を付けます
  • 認証フォーム:フロントエンドルールがある場合は、マーケティングパネル、PasswordInput、i18n キーを使用します
  • i18n:すべての文字列に翻訳キーを使用し、日付/通貨には useFormat() を使用します
  • ナビゲーション:メニュー項目を追加する場合、ナビゲーションルールがあれば groupKey を指定します

バックエンドの追加事項

uses_grogoo: false(デフォルト)の場合:Sanctum と手動モジュールを使用し、Grogoo への参照は含めません。

マルチテナンシーを使用する場合:criteria 内で company_id と所有権を明示的に検証します。

出力先

{product_root}/docs/versions/{version_san}/tasks/task-NNN-slug.md

サブバージョンの場合は、subversions/{subversion_san}/tasks/ の下に出力します。

参考資料

ファイル使用する場面
references/task-schema.mdMarkdown テンプレートとヘッダーフィールド全体

関連スキル

  • unit-test-task-generator — バックエンド実装タスクの後
  • e2e-test-generator — UI を含むフロントエンドタスクの後
  • execution-handoff-generator — バージョン内のすべてのタスクを書き終えた後(計画の締めくくり)

コメント