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 文档。

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 关心的是触发器、状态机、产物路径，而不是单行代码风格。

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（或用户级 Skills 目录）。Agent 先读 frontmatter 里的 description，匹配后再加载正文，因此比 Rules 更省上下文。深度 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 开放标准