mcpField
A
app-implement

app-implement

github.com/cribl-community開発468 回インストール10 週間前に更新
リポジトリ

app-implement について

app-implementは、APP_BRIEF.mdに基づいて、スキャフォールド済みのCriblアプリを変更するスキルです。前回の実行時との差分を処理し、--dry-runで予定変更を一覧表示できます。

主な機能

  1. 01ブリーフと前回の実行内容を比較
  2. 02差分を実装タスクに分解
  3. 03--dry-runで変更をプレビュー
  4. 04実行後にブリーフを基準として保存

活用シーン

  1. 01更新されたブリーフに基づくアプリ変更
  2. 02実行前に予定タスクを確認

インストール

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

$npx skills add https://github.com/cribl-community/claude-cribl-app-plugins --skill app-implement

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

同梱ファイルreferences/cribl-apps-guidance.mdreferences/policies.yml

詳細

app-implement APP_BRIEF.md に基づいてアプリの変更を実装します。前回の実行内容と比較し、差分を実装します。 --dry-run (任意)：実行せず、予定されている変更を表示します /app-implement /app-implement --dry-run

実行前チェック

先に進む前に、Cribl アプリのスキャフォールドフォルダー内にいることを確認してください。そうでない場合は停止し、ユーザーに「スキャフォールドされた Cribl アプリのフォルダー内からこのスキルを実行する必要があります。」と伝えてください。

手順

APP_BRIEF.md ファイルに基づいて Cribl アプリを実装します。すべてのコンポーネントには、デフォルトで Capra UI を使用してください。 開始する前に、./references/cribl-apps-guidance.md を確認し、KV ストア、状態管理、エラー処理、その他の Cribl 固有のパターンに関する一般的な落とし穴を避けてください。

次のワークフローに従ってください。

1. 前提条件を確認する

  • 作業ディレクトリに APP_BRIEF.md が存在することを確認します
  • 見つからない場合は、「APP_BRIEF.md が見つかりません。先に /app-brief を実行してください。」というエラーを出します
  • /executions ディレクトリが存在しない場合は作成します

2. バージョンを読み込み、比較する

  • 現在の APP_BRIEF.md を読み込みます
  • /executions 内で最新の APP_BRIEF_*.md を探します（ファイル名のタイムスタンプ順に並べ替えます）
  • 過去の実行がない場合：現在のブリーフ全体を新しい作業として扱います（差分 = すべて）
  • 過去の実行がある場合：2 つを差分比較し、次の項目を特定します。
    • 新しいセクションや要件
    • 変更されたセクションや要件
    • 削除されたセクション（注：元に戻さないでください）

3. 差分をアクションアイテムに変換する

  • 差分から具体的な実装タスクを抽出します
  • 各タスクについて、実施内容を明確に示す、実行可能な 1 行を作成します
  • 例：
    • 新しいコンポーネント UserInput を作成する
    • フィルタリングをサポートするように API エンドポイント /search を更新する
    • AuthService のテストカバレッジを追加する

4. ドライランモード（--dry-run フラグが指定された場合）

  • ヘッダー「=== ドライラン：予定されている変更 ===」を出力します
  • 各アクションアイテムを 1 行ずつ出力します（説明は付けず、アクションのみ）
  • フッター「=== ドライラン終了 ===」を出力します
  • 出力例： 
    === DRY RUN: Planned Changes ===
Create new component: UserInput
Update API endpoint /search to support filtering
Add test coverage for AuthService
=== End Dry Run ===

5. 実装モード（通常実行、--dry-run なし）

  • 差分を実行します。必要に応じてファイルの作成、コードの変更、設定の更新を行います
  • APP_DEFINITION.md の「## App ID」セクションからアプリ ID を読み取ります
  • package.json の "name" フィールドをアプリ ID に合わせて更新します
  • すべてのリンターエラーを解消し、npm run lint を実行します

6. 今回の実行をアーカイブする

  • 現在の APP_BRIEF.md を /executions/APP_BRIEF_[ISO8601-timestamp].md にコピーします
  • 次の形式を使用します：APP_BRIEF_2026-07-31T14-30-45Z.md（ISO 8601 形式。ファイルシステムとの互換性のため、コロンはハイフンに置き換えます）
  • これを次回実行時のベースラインとします

7. package.json の更新を確認する

  • package.json の "name" フィールドが APP_DEFINITION.md のアプリ ID と一致していることを確認します

重要な原則

  • 信頼できる情報源：常に現在の APP_BRIEF.md を優先します
  • 冪等性：このスキルは繰り返し実行できます。各実行では変更された部分のみを対象にします
  • 実行間の状態を保持しない：状態の永続化には /executions フォルダーのみを使用します

コメント

Markdown 対応