企业官网建设流程全解析

Agent Harness工程详解：Rules、Skills、Agents核心要素与协作规范

同一个接口，让 AI 写三遍，往往会得到三套 URL、三种返回结构。你在对话里强调「跟现有写法保持一致」，这一轮它照做了，新开一个会话又按自己的习惯来。规范停在聊天记录里，进不了下一次任务。

再往下更费时间：一次对话里，它同时拆需求、写代码、补测试、做评审。方案、实现和测试文档各说各的，对不齐。改提示词只能管住这一轮，下一轮又要从头说。跨会话之后，标准丢了，工具没接上，岗位也混在同一次对话里。

我们得出一个核心结论：AI 开发不稳定、靠玄学、反复翻车，根本原因是只有“单次提示词”，没有“长期工程驾驭体系”。

真正能让 AI 在项目中稳定、规范、可持续交付的核心，是开发者自建的 Outer Harness。而整套 Outer Harness 的工程地基，由三大核心构件构成：

Rules（静态工程契约）

Skills（动态执行能力）

Agents（专业化执行角色）

很多人用不好 Qoder、Cursor 的高级能力，并不是工具不强，而是分不清这三者的职责、边界与协作关系。

本篇将从软件工程、软件全生命周期视角，纯基础、无超前内容，系统讲解三大构件的准确定义、核心作用、协作逻辑，为后续全流程工程落地打下统一标准。

一、为什么项目 Harness 必须包含这三者？

传统软件工程开发，是一套完整闭环体系：有规范标准、有工具链路、有岗位分工。

但绝大多数人使用 AI 开发的模式，是碎片化提示词模式：
每次对话重新约定规范、每次任务全靠模型脑补、没有固定标准、没有工具校验、没有角色区分。

所以必然出现：

代码风格忽左忽右

架构实现前后不一致

时而精简、时而冗余

经常漏掉工程规范、边界条件、异常处理

工程化 AI 开发的核心改造，就是把“随口说说的提示词”，替换成“结构化的三大工程构件”：

Rules 负责定标准（让AI知道什么是对、什么是错）

Skills 负责给工具（让AI能真实操作项目、校验项目）

Agents 负责分岗位（让AI各司其职、专业化工作）

三者缺一不可，共同组成项目可迭代、可沉淀、可团队复用的 Agent 驾驭体系。

二、Harness 三大核心构件完整概念定义

1. Rules：静态工程契约（项目的“铁律规范”）

Rules 是项目长期固定、不可随意突破的静态工程约束与契约标准。

它不执行任何动作、不提供任何能力，只负责约束与定义底线，是所有 AI 输出的前置审核标准。

Rules 规范的是「工程标准」，主要包含：

项目总图、目录、技术栈、调用链、统一响应、接口速查

项目整体架构规范、分层原则

代码风格、命名规范

注释标准、版权声明

全局异常处理，业务异常定义

接口风格、方法规范、统一响应契约

服务层测试规范、断言方式

统一日志规范、日志打印规范、日志输出格式

禁止使用的语法、类库、写法

业务代码红线、安全约束

核心特点：静态、全局、强制、长期有效

通俗理解：

Rules 就是项目的《开发手册》，只要在本项目开发，所有 AI 行为必须遵守。

2. Skills：动态执行能力（Agent的“工具箱”）

如果说 Rules 是「规矩」，Skills 就是 Agent 可以真实调用的工具与执行能力。

单纯靠模型文本推理，永远会脱离项目真实环境。想要 AI 落地工程化，必须赋予它操作项目的能力。

Skills 主要覆盖：

按需求生成产品文档PRD能力

按表结构生成建表与改表 SQL 能力

按数据表生成 DO 与 Mapper 能力

按实体生成 Service 与对象转换能力

按资源生成 Controller 与请求入参能力

按接口契约生成联调测试文档能力

按测试文档执行接口测试并出报告能力

按缺陷完成定位、修复与验证能力

按查询条件只读查库能力

按测试需要构造与清理数据能力

核心特点：动态、可执行、可调用、可闭环

通俗理解：

Rules 告诉 AI「应该怎么写」，Skills 告诉 AI「可以怎么干、用什么工具验证」。

3. Agents：专业化执行角色（AI的“岗位分工”）

Agents 是承载任务、遵守规则、调用工具的具体执行主体。

传统软件工程有架构师、开发、测试、评审岗位；AI 工程化中，同样需要角色解耦。

单一通用大模型角色，同时负责架构、编码、测试、修复，必然混乱、不专业、顾此失彼。

通过 Agents 可以拆分出独立岗位，例如：

架构 Agent：负责需求拆解、模块设计、架构评审

开发 Agent：负责业务编码、功能实现、代码重构

测试 Agent：负责用例编写、自动化测试、缺陷校验

评审 Agent：负责代码规范检查、风险识别

运维 Agent：负责部署、监控、日志分析

核心特点：权限隔离、职责单一、规则继承、能力按需绑定

通俗理解：

Rules 是制度，Skills 是工具，Agents 是在岗干活的人。

三、三大构件的层级关系与协作逻辑

这是整篇 Harness 工程体系最核心的底层逻辑：

黄金协作公式

Rules 定底线 → Skills 给能力 → Agents 做执行

Rules 约束所有 Agents

所有角色、所有任务，必须统一遵守项目规则，保证全项目输出标准一致。
2. Skills 服务所有 Agents
工具能力全局复用，不同 Agent 按需调用，不用重复造轮子。
3. Agents 承载所有业务闭环
以角色为单位，接收需求、遵守规范、调用工具、完成交付。

完整协作链路

需求下发 → Agent 读取 Rules 规范 → 调用 Skills 工具 → 标准化生成代码 → 工具自动校验 → 闭环交付

三者相互依赖、相互制约，构成完整可控的 AI 工程体系：

无 Rules：AI 自由发挥，标准崩塌

无 Skills：AI 纸上谈兵，脱离真实项目

无 Agents：任务混杂混乱，无法专业化落地

四、可视化：Harness 整体架构与任务闭环流程

为方便直观理解三者关系，这里附上整套体系架构图与执行时序图。

1. Harness 三大构件架构关系图
   

2. AI 开发任务完整闭环时序图

需求下发后，架构、开发、测试、评审、运维各岗位读取 Rules、按岗位调用 Skills，再闭环交付。