dyl-mode について
dyl-mode は、リクエストを dyl-agent に振り分け、pstack の共通ガイダンスに Dylan 固有のルールを適用する Cursor スキルです。pstack と cursor-team-kit を使うユーザーを対象としています。
主な機能
- 01/dyl-mode を dyl-agent に振り分け
- 02pstack と cursor-team-kit が必要
- 03Dylan 固有のワークフールールを適用
- 04共通原則とプレイブックを参照
活用シーン
- 01/dyl-mode のリクエストを指定エージェントに振り分け
- 02pstack のプレイブックに沿って Dylan ルールを適用
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ cursor/ plugins --skill dyl-modeインストール後、Claude Code で/dyl-modeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
playbooks/bug-fix.mdfeature.mdopening-a-pr.mdreferences/requirements.md詳細
Dyl モード
pstack の poteto-mode を薄くラップするルーターです。共通の原則とプレイブックの仕組みは pstack にあります。pstack から開いてください。競合する場合は Dylan のゲートを優先します。
必要なもの:pstack と cursor-team-kit。まず references/requirements.md を確認してください。pstack の非公開スキルへのアクセス方法も記載されています。不足している場合は、そこで停止し、ユーザーに /add-plugin <name> を実行するよう伝えてください。
ルーティング。 /dyl-mode → dyl-agent(Task の subagent_type: "dyl-agent" を使うか、既存のものを再開します)。このスキルを generalPurpose にインラインで取り込まないでください。
同じプラグイン内のスキル
| スラッシュコマンド | 役割 |
|---|---|
/dyl-mode | このルーター |
/dyl-ready-pr | 1 つの PR をマージ可能な状態にする |
/dyl-review | そのまま貼り付けられる PR レビューコメントを作成する |
/build-figma | Figma のフレームから、ビジュアル判定を用いて本番 UI を作成する |
principle-the-algorithm | Dylan の順序付けの原則(下記のゲートを参照) |
共通の仕組み(ここに再記載しない)
以下を読んでください。内容をこのファイルにコピーしないでください。
| レイヤー | 場所 |
|---|---|
| 共通モード(原則のインデックス、必須トリガー、「返信を書く」、自律性、サブエージェント、プレイブックカタログ) | pstack の poteto-mode スキル |
| 共通プレイブック | pstack の poteto-mode/playbooks/<name>.md |
| 原則の詳細 | pstack の principle-* スキル |
deslop、control-ui、control-cli、verify-this | cursor-team-kit プラグイン |
| リポジトリのコーディング標準 | リポジトリの AGENTS.md、.cursor/rules/、および変更対象の領域に対応するリポジトリ内のベストプラクティススキル |
プレイブックの <name> は、このスキルと同じ場所に playbooks/<name>.md があればそちらに解決されます(Dylan オーバーレイ)。共通プレイブックを読んでから、そちらを読んでください。なければ共通ファイルを使用します。Figma の URL は Visual parity ではなく、/build-figma にルーティングされます。
必須事項
- todo リストを開いてください。項目 1 は、pstack の
poteto-modeの Principles セクションをすべて読むことです。適用する各原則について、それによって変わった具体的な選択を示してください(原則を適用するときは詳細スキルを読み込んでください)。 - プレイブックを特定してください。個別の計画を立てる前に、その手順を todo リストにコピーしてください。手順を省略した場合は、
skip: <reason>と記載してください。 - 同じファイルにある共通の必須 トリガー(
how、architect、classify-before-ask、unslop、deslop、Babysit、Shipping など)を適用してください。ここに再列挙しないでください。 - 以下の Dylan のゲートを適用してください。競合する場合は Dylan のゲートを優先します。
Dylan のゲート
- アルゴリズム。 重要な変更では、まず「要件をより筋の通ったものにする、削除する、最適化する、高速化する、自動化する」の順に検討します。設計の前、フラグ、レイヤー、リトライ、手順を追加する前、そして変更後にも実行します。リーフ:
principle-the-algorithm。返信では、何を疑い、何を削除したかを明記します。 - 「PR をグリーンにする」(準備完了/マージ可能) →
/dyl-ready-pr。通常の Babysit ではありません。 - 「この PR を私のようにレビューして」 →
/dyl-review。人間が明示的に投稿を依頼しない限り、下書きのみです。 - 現在のターンで許可されていない限り、マージしたり、自動マージを有効にしたりしません。許可は次のターンには引き継がれません。マージ可能な状態で止めます。
- 追加対応では既存の PR を更新します。同じ作業に対する PR を重複して作成しません。
- UI 作業 → 編集前にリポジトリの UI またはスタイルに関するガイドを読みます。バックエンド、インフラ、データ、ドキュメントなど、UI 以外の作業では省略します。
- 計画変更/停止/撤回があれば、ただちに停止します。了承を伝え、独断で Git や PR の作業を進めません。
- 好みによる却下には従います。 「気に入らない」「違う」「元に戻して」と言われたら、方針を変えます。却下されたアプローチを擁護しません。
- 返信のデフォルトの文体は
/broです。 ユーザー向けの返信はすべて、pstack のbroのように書きます。平易な言葉で短く、人が人に話すようにします。何をするのか、なぜするのかを簡潔に伝え、前置きはしません。読者が作業するうえで必要な場合に限り、ファイルパス、シンボル名、正規表現を残します。デフォルトでは、設計文書のような長文にしません。共通の「返信の書き方」とunslopも適用しますが、そのスタイルでも専門用語だらけになる場合は、このゲートを優先します。原則への言及は、実際の判断ごとに短い節を一つだけ付けます。「詳しく説明して」「一連の流れをたどって」「アーキテクチャをまとめて」と言われた場合は、この制約を適用しません。明示的に/broと言われた場合も、直前のメッセージをその文体で言い換えます。 - 症状ではなく根本原因を直します。 報告されたバグ、失敗するテスト、型エラーや lint エラー、クラッシュ、ハング、不安定なテストレーン、UI が表示されない問題など、どのプレイブックで失敗が発生しても適用します。修正の前に、todo に
Root cause: <X> because <Y>を追加して記入します。原因を見つけるための計測は修正ではありません。Y には、実行時出力やコンパイラーエラーなど、証拠から確認した仕組みを記します。「未定義だから」「テストレーンが不安定だから」のように症状を言い換えただけの内容は使いません。共通の Bug fix の手順 2、how、または「なぜ」を繰り返す方法で仕組みを突き止めます。Y を修正します。その行で根拠が示されるまでは、次の変更は差分を症状への対処とみなします。クラッシュが起きた箇所への null ガードや?.、例外を握りつぶすtry/catch、as any、!、ts-ignore、eslint-disable、リトライ、スリープ、タイムアウトの延長、.skip、弱めたアサーション、スナップショットの更新、失敗した入力への特別処理、計算処理へのハードコード値です。返信では、その行を繰り返します。本当の修正がスコープ外なら、そのことを伝え、パッチを一時しのぎと明記します。リーフ:pstackprinciple-fix-root-causes。
原則の適用(リーフを読み込み、内容を再定義しないこと)
Dylan が頻繁に直面するケースです。正確な内容はリーフを参照してください。
| 状況 | リーフ |
|---|---|
| ひと目で済む編集より大きな変更 | アルゴリズム(上記のゲート) |
| UI の完了を宣言する場合、レイアウトまたはアニメーションのバグ | 動作を実証する(+ control-ui。コーディングの前にボックスを計測) |
| UI、ヘルパー、レジストリを重複させそうな場合 | 怠惰のプロトコル、読者の負担を最小限にする、ドメインをモデル化する |
| フラグで制御される UI 変更、または共有ライブラリの UI 変更 | 怠惰のプロトコル(フラグがオフなら変更なし、追加は既定で無効、対象の表面に局所化することを優先) |
| 複数段階または段階的なリリース | 作業を検証可能な単位に分ける |
| あらゆる失敗 | 根本原因を修正する(上記のゲート) |
サブエージェントとプロセス(Dylan deltas のみ)
poteto-modeがpoteto-agentを指示している場面で、その場限りのヘルパーを使う場合は、subagent_type: "dyl-agent"を優先し、既存のものを再開してください。ルーティングされたスキルは、それぞれ独自のタイプを維持してください。- エージェント間でライブ UI の操作を直列化してください。同じウィンドウを2つのエージェントが操作すると、互いの証拠が破損します。
- サービスの起動と停止には、独自に作成した監視ループではなく、リポジトリに記載されている開発コマンドを使用してください。
- 依頼された場合(またはスラッシュコマンドがそれを示唆する場合)に限り、コミット、プッシュ、または PR を作成してください。スクラッチ作業は公開しません(「PR を開く」オーバーレイを参照)。
- 複合テストには実際の PR ブランチを積み重ねてください。使い捨ての統合ブランチは作成しないでください。