exec-plan Skill
description: ExecPlan(実行計画)の作成・検証・更新を支援するスキル。複雑なタスク(新機能開発、リファクタリング、バグ修正)の設計フェーズで使用します。`/create-plan`でプラン作成を開始。
Want an agent-native computer in the browser? Try HappyCapy.
Cloud sandbox for AI agents · No setup · Run autonomous workflows from your browser
Affiliate link — we may earn a commission at no extra cost to you.
Why use this skill
exec-plan is most useful when you want an agent workflow that is more structured than an ad-hoc prompt. Instead of restating the same expectations every time, a dedicated SKILL.md file gives the assistant a repeatable brief. In this case, the core value is clarity: the repo already frames the workflow around productivity skills tasks, and the skill source gives you a portable starting point you can evaluate, adapt, and reuse. The inferred platform for this skill is Codex Skills, which helps you judge whether it is likely to feel native in your current agent ecosystem or whether it is better treated as a general reference.
That matters because AI assistants are better when the operating context is explicit. A good skill turns hidden team expectations into visible instructions. It can name preferred tools, describe failure modes, define what “done” looks like, and reduce the amount of corrective prompting you need after the first draft. For developers exploring the wider SKILL.md ecosystem, this page helps answer the practical question: is this skill specific and maintained enough to be worth trying?
How to evaluate and use it
Start with the source repo and the preview below. The preview tells you whether the instructions are actionable or just aspirational. Strong skills usually describe triggers, recommended tools, steps, and known pitfalls. Weak skills tend to stay generic. This one lives in modxcms-jp/evolution-jp, which gives you a concrete repo context, update history, and direct ownership trail.
Once you confirm the scope looks right, test it on a small task before making it part of a larger workflow. If it improves consistency, keep it. If it is too broad, outdated, or conflicts with your own process, treat it as a reference rather than a drop-in rule. That is the healthiest way to use directory-discovered skills: not as magic plugins, but as reusable operational knowledge that still deserves judgment.
SKILL.md preview
Previewing the source is one of the fastest ways to judge whether a skill is truly useful. This snippet comes from the public file in the linked repository.
--- name: exec-plan description: ExecPlan(実行計画)の作成・検証・更新を支援するスキル。複雑なタスク(新機能開発、リファクタリング、バグ修正)の設計フェーズで使用します。`/create-plan`でプラン作成を開始。 --- # Exec Plan `.agent/PLANS.md` の仕様に準拠した ExecPlan を作成・管理するワークフロー。 コーディング規約・ドキュメントマップは `AGENTS.md` を参照。 ## コマンド ### /create-plan <タスク概要> 1. `AGENTS.md` のドキュメントマップから関連ドキュメント・コードを探索 2. プラン案の骨子を提示(重点: Purpose / Context / Plan of Work / Concrete Steps / Validation) 複雑タスクはマイルストーン分割(目標→作業→成果→検証の物語構造、PoCを先行) 3. エンジニアと設計方針を確認し、非交渉要件(自己完結・初心者実行可能・動作する成果物・用語定義)を検討 4. `.agent/PLANS.md` テンプレートに従い `.agent/plans/YYYY-MM-DD-task-name.md` を作成 全12セクション記載、Progress以外は散文、CMS用語を定義、Validationは観察可能な動作で定義 空セクションは見出しのみ残す(プレースホルダ説明は書かない) 5. `/validate-plan` を自動実行 トークン効率の原則(精度優先): - 実装精度・再現性を落とさない範囲で簡潔に書く(必要十分な情報量を維持) - 同一趣旨の説明を複数セクションに重複記載しない - 長大なコード全文は原則避け、変更意図・対象箇所・確認コマンドに集約する - `Concrete Steps` は「編集対象ファイル / 実行コマンド / 期待観測結果」を基本フォーマットにする 探索の重点: `assets/docs/architecture.md`(処理フロー)、`assets/docs/events-and-plugins.md`(フック)、`assets/docs/core-issues.md`(既知の課題)、対象ファイルの既存パターン 移行タスクでは追加で: 旧API使用箇所のGrep棚卸し、旧→新の置換パターン表、モジュール単位の分割 ### 補助ツール(CLI導入済みの場合) `php evo config:show [key]` / `db:tables [--pattern]` / `db:describe <table>` / `db:count <table> [--where]` ### /validate-plan [path] `references/quality-checklist.md` に基づき品質チェック: 必須12セクション、非交渉要件・アンチパターンを検出し改善提案 ### /update-plan [path] 各マイルストーン完了時・中断時にこまめに呼び出す: 1. Progress をタイムスタンプ付きで更新(完了チェック、新規項目追加) 2. Surprises & Discoveries に追記(観察+根拠) 3. Decision Log に日付・著者・根拠・代替案を記録 4. 完了マイルストーンの Progress 詳細を1行の要約に圧縮(トークン節約) 5. コア側の課題(UI結合・設計上の制約・技術的負債等)を発見した場合は `assets/docs/core-issues.md` に追記(発見日・発見元・ファイル・課題・改善案・関連ロードマッ ...