AI Coding Workflow・Rules・Skills 完全解説（例付き）

1. なぜ AI コーディングに Workflow・Rules・Skills の層分けが必要か

AI コーディングアシスタントはツール呼び出し付き Agentだ：リポジトリを読み、ファイルを編集し、ターミナルを実行する。弱点も明確——新しいチャットは毎回記憶喪失、チーム規範を prompt に再注入しない限り。さらに悪いのは、コードスタイル・Git 規約・リリース checklist・障害 Runbook を 1 本の User Rule に詰め込むこと。各メッセージが数千 token のポリシーを背負い、diff やログの余地を奪う。

2026 年のベストプラクティスは制約と手順を 3 層に分けること：

• Workflow：AI タスクの起動方法——スラッシュコマンド、Plan/Agent モード、CI トリガー、リモート Agent 編成。
• Rules：常に成立すること——言語スタイル、編集禁止ディレクトリ、テスト要件、セキュリティ紅線。
• Skills：オンデマンドで実行——code review checklist、Xcode リリース、移行 Runbook。通常 SKILL.md に記述。

これはAgent 開発モード選定と同じ論理：エントリーポイントが行動境界を決め、モデルパラメータ表ではない。Skills のオープン標準は Agent Skills Specification；Cursor Rules は 公式ドキュメントを参照。

層分けはレビュー可能性も高める。Rule を 1 行変えると今後の全会話が変わる——慎重な PR が必要。Skill を更新しても、その Skill を呼ぶときだけコンテキストコストが発生する。Workflow の変更はコマンド doc や CI ジョブの更新で済み、グローバル挙動に触れない。ガバナンスチームは Rules を四半期ごとに監査し、プラットフォームチームは Skills を社内ライブラリのようにバージョン管理できる。

空港の保安検査と飛行マニュアルに例えると分かりやすい。Rules は金属探知機——常時オン、全員同じ。Skills は機種別のパイロット checklist——その機体が滑走路にいるときだけ引き出す。Workflow は管制塔——誰に許可を出し、どの順序で、どの滑走路を使うか。三者を 1 つの塊に混ぜると、8,000 token の system prompt になり、モデルは現在の編集に無関係な半分を無視しがちだ。

層分けはオンボーディングの再現性も上げる。新メンバーは clone するだけで同じ Rules とプロジェクト Skills を継承する。.cursor/commands/ の README から Workflow を学べ、Slack の口伝えに依存しない——AI 支援開発をパワーユーザー少数からチーム全体に広げる鍵だ。

2. Workflow / Rules / Skills の分類（What）

2.1 Workflow — タスクの起動と編成

Workflow は誰がいつ Agent を起動するかに答える。典型例：Cursor の /generate-blog 系カスタムコマンド、Plan Mode と Agent Mode の切替、Claude Code の /loop とバッチ、GitHub Actions で AI が CI を修正、OpenClaw 系ゲートウェイが Telegram/cron をリモート Mac に接続。Workflow はトリガー、ステートマシン、成果物パスを扱い、1 行のフォーマット規約ではない。成熟した Workflow はゲートを文書化する：「brief 承認 → zh 生成 → 人間 OK → i18n」。成果物（articles.json、ステージング画像）と失敗時の挙動（リトライ、通知、停止）も明記する。ゲートがなければ Agent は即興し、即興は本番インシデントの温床だ。

2.2 Rules — 常時有効な制約層

Rules は常駐コンテキスト。Cursor では .cursor/rules/*.mdc（プロジェクト）、Settings の Rules、ルート AGENTS.md が一般的。最小 diff、触ってはいけないディレクトリ、コミット規約、返答言語、テスト必須条件を書く。Rules は短く、硬く、実行可能に。30 ステップのリリース手順は Rule ではなく Skill へ。条件付きロジックが必要なら glob 付き .mdc を分割する。

2.3 Skills — オンデマンド Runbook

Skills はオンデマンド読み込みのワークフローパッケージ。Claude Code は .claude/skills/<name>/SKILL.md；Cursor は .cursor/skills/<name>/SKILL.md。Agent は frontmatter の description を先に読み、マッチ時のみ本文をロード。詳細はClaude Code Skills 10 フレームワークガイドを参照。高リスク Skill は disable-model-invocation: true で明示呼び出しのみに限定する。

3. 核心比較表

3.1 Rules と Skills の分担早見表

4. シナリオ別の選び方

5. 推奨スタック

スタック A — 最小構成（半日）

• User Rules 3 条：最小 diff、勝手に commit しない、編集後 lint
• プロジェクト .cursor/rules/blog-writing.mdc は当該リポジトリ固有のみ
• 個人 Skill commit：staged diff から Conventional Commits

スタック B — チーム規範

• Rules：testing.mdc + security.mdc（各 80 行未満）
• Skills：code-review、security-review（手動トリガー）
• Workflow：PR テンプレに「マージ前 /security-review」

スタック C — iOS デリバリー

• Skill xcode-release（disable-model-invocation: true）
• Rules：明示要求以外 *.xcodeproj 変更禁止
• 実行ノード：ローカル M4 または Hashvps クラウド Mac。GitHub Actions macOS ビルド動向と併用し重コンパイルはリモートへ

スタック D — コンテンツ/ドキュメント工程

• Workflow：/generate-blog 系（brief → zh → i18n ゲート）
• Rules：blog-standard-spec-v1.mdc
• Skills：translate-to、seo-optimize オンデマンド

6. よくある誤解

• 「全部 User Rules が楽」 → 常駐 prompt 膨張；Runbook は Skills へ。
• 「Skills は多いほど良い」 → description が競合；10 個以内で境界明確に。
• 「Workflow が CI を代替」 → AI は開発支援；ゲートは GitHub Actions / Xcode Cloud に硬编码。
• 「Rules と Skills を同じファイルで」 → レビューとロード機構が異なる；Rules 1 行変更が全会話に影響。
• 「Mac なしで xcode-release Skill」 → codesign は macOS 必須。ローカル or クラウド Mac。
• 「Plan Mode = Workflow」 → Plan は対話モード；Workflow は再現可能・スクリプト化されたトリガーと成果物約束。

7. 7 ステップ導入：コピペ例付き

1. 繰り返し prompt を監査：先週 3 回同じ review 清单？→ Skill 候補。
2. Rules 3 条：「常に真」の紅線のみ、各 1 画面で読める。
3. Skill ディレクトリ作成：mkdir -p .cursor/skills/code-review（Cursor）または .claude/skills/code-review（Claude Code）。
4. SKILL.md frontmatter：description は「動詞 + シーン」；高リスクは disable-model-invocation: true。
5. Workflow 定義：「brief OK → i18n」ゲートを .cursor/commands/*.md に。
6. Git コミット：Rules とプロジェクト Skills をコードと同 PR に。
7. 実行ノード紐付け：shell/Xcode を含む Workflow は macOS ホスト（ローカル or クラウド Mac）へ。

# .cursor/rules/core.mdc
---
description: Core engineering constraints for this repo
globs: "**/*"
---
- Minimize diff scope; do not refactor unrelated code.
- Never commit unless the user explicitly asks.
- Run tests for touched packages before claiming done.

# .cursor/skills/code-review/SKILL.md
---
name: code-review
description: Review staged git diff for bugs, security, and test gaps. Use when user asks for review or before PR.
---
1. Run `git diff --staged` (or compare branch to main).
2. Output: Critical / Warning / Suggestion in three sections.
3. Do not auto-fix unless user asks.

# .cursor/commands/release-ios.md
## Workflow
1. User confirms brief / scope on main branch.
2. Agent runs /test-runner Skill on changed targets.
3. Manual /xcode-release only after CI green.
4. Post changelog; never skip codesign on shared runner.

8. まとめ

2026 年の AI コーディング競争力は、単一モデルスコアよりワークフロー工学に依存する。Workflow はタスクの起動方法、Rules は常に成立する底线、Skills はベテランの checklist をバージョン化・共有可能な Runbook にする。まず層分け、それから高額サブスクを検討。

非対称な結論を忘れずに：モデル能力は分水嶺ではない。エントリーポイントと実行境界が分水嶺だ。 延伸阅读：Cursor Rules · Claude Code Skills · Agent Skills 標準