AI Coding Workflow、Rules、Skills 完整解析（附範例）

1. 為什麼 AI 程式設計需要 Workflow、Rules、Skills 分層？

AI 程式設計助手本質是帶工具呼叫的 Agent：能讀倉庫、改檔案、跑終端。但它的弱點也很明顯——每次新會話都像「失憶開局」，除非你反覆把團隊規範塞進 prompt。更麻煩的是：有人把「程式碼風格」「Git 規範」「發布 checklist」「排障 Runbook」全寫進一條 User Rule，結果每條訊息都背著幾千 token，真正幹活時反而擠佔了 diff 和日誌的空間。

2026 年的最佳實踐是把約束與流程拆開三層：

• Workflow：你怎麼啟動一次 AI 任務——斜線命令、Plan/Agent 模式、CI 觸發、遠端 Agent 編排。
• Rules：什麼始終成立——語言風格、禁止改後端、測試要求、安全紅線。
• Skills：什麼按需執行——code review 清單、Xcode 發布、遷移 Runbook，通常寫在 SKILL.md 裡。

這和Agent 開發模式選型是同一邏輯：入口決定行為邊界，而不是模型參數表。官方對 Skills 的開放標準見 Agent Skills Specification；Cursor 對 Rules 的說明見 Cursor Rules 文件。

分層也提升可審查性：改一行 Rule 會影響之後每次對話，值得仔細 PR；更新 Skill 只有呼叫時才付上下文成本；Workflow 變更只動命令文件或 CI，不碰全域行為。治理團隊可每季審計 Rules；平台團隊像內部函式庫一樣版本化 Skills；DevOps 擁有 Workflows。

用機場安檢對照飛行手冊來想：Rules 是金屬探測門——常開、人人相同；Skills 是特定機型的飛行員 checklist——飛機在滑行道時才拿出來；Workflow 是塔台——誰獲得許可、順序為何、用哪條跑道。三者混成一大段，就會變成 8,000 token 的 system prompt，模型常忽略與當前編輯無關的一半內容。

分層也讓onboarding 可衡量：新人 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/定時器接到遠端 Mac。Workflow 關心的是觸發器、狀態機、產物路徑，而不是單行程式碼風格。成熟的 Workflow 會寫明閘門：「brief 核准 → 產生 zh → 人工 OK → i18n」，並命名產物（articles.json、staging 圖片）與失敗行為（重試、通知、中止）。沒有明確閘門，Agent 會即興發揮——而即興正是生產事故的起點。

2.2 Rules — 始終生效的約束層

Rules 是常駐上下文，在 Cursor 裡常見位置有：.cursor/rules/*.mdc（專案級）、使用者 Settings 裡的 Rules、以及根目錄 AGENTS.md。適合寫：最小 diff 原則、禁止改哪些目錄、commit 規範、回覆語言、何時必須跑測試。Rules 應該短、硬、可執行；不要把 30 步發布流程塞進 Rule——那是 Skill 的活。

2.3 Skills — 按需載入的 Runbook

Skills 是按需載入的工作流套件。Claude Code 用 .claude/skills/<name>/SKILL.md；Cursor 用 .cursor/skills/<name>/SKILL.md。Agent 先讀 frontmatter 裡的 description，匹配後再載入正文。深度 Skill 選型可參考站內 Claude Code Skills 10 框架指南。

3. 核心對比表（How Compare）

3.1 Rules 與 Skills 分工速查

4. 場景怎麼選？決策矩陣

5. 推薦組合（Stack）

組合 A — 最小可行（半天內）

• User Rules 三條：最小 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 改一行影響每次對話。
• 「沒有 Mac 也能跑 xcode-release Skill」 → codesign 依賴 macOS，需本機或雲端 Mac 節點。
• 「Plan Mode 等於 Workflow」 → Plan 是互動模式；Workflow 是可重複、可腳本化的觸發與產物約定。

7. 七步落地：附可複製範例

1. 審計重複 prompt：上週你是否第三次輸入同一套 review 清單？是 → 候選 Skill。
2. 寫 3 條 Rules：只保留「永遠成立」的紅線，每條可在一屏內讀完。
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 或團隊 Runbook。
6. 提交 Git：Rules 與專案 Skills 與程式碼同 PR，避免只有資深員工本機有設定。
7. 綁定執行節點：含 shell/Xcode 的 Workflow 指向 macOS 主機（本機或雲 Mac），SSH 進去環境一致。

# .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 開放標準