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 三大核心构件完整概念定义Rules静态工程契约项目的“铁律规范”Rules 是项目长期固定、不可随意突破的静态工程约束与契约标准。它不执行任何动作、不提供任何能力只负责约束与定义底线是所有 AI 输出的前置审核标准。Rules 规范的是「工程标准」主要包含项目总图、目录、技术栈、调用链、统一响应、接口速查项目整体架构规范、分层原则代码风格、命名规范注释标准、版权声明全局异常处理业务异常定义接口风格、方法规范、统一响应契约服务层测试规范、断言方式统一日志规范、日志打印规范、日志输出格式禁止使用的语法、类库、写法业务代码红线、安全约束核心特点静态、全局、强制、长期有效通俗理解Rules 就是项目的《开发手册》只要在本项目开发所有 AI 行为必须遵守。Skills动态执行能力Agent的“工具箱”如果说 Rules 是「规矩」Skills 就是 Agent 可以真实调用的工具与执行能力。单纯靠模型文本推理永远会脱离项目真实环境。想要 AI 落地工程化必须赋予它操作项目的能力。Skills 主要覆盖按需求生成产品文档PRD能力按表结构生成建表与改表 SQL 能力按数据表生成 DO 与 Mapper 能力按实体生成 Service 与对象转换能力按资源生成 Controller 与请求入参能力按接口契约生成联调测试文档能力按测试文档执行接口测试并出报告能力按缺陷完成定位、修复与验证能力按查询条件只读查库能力按测试需要构造与清理数据能力核心特点动态、可执行、可调用、可闭环通俗理解Rules 告诉 AI「应该怎么写」Skills 告诉 AI「可以怎么干、用什么工具验证」。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 工程体系无 RulesAI 自由发挥标准崩塌无 SkillsAI 纸上谈兵脱离真实项目无 Agents任务混杂混乱无法专业化落地四、可视化Harness 整体架构与任务闭环流程为方便直观理解三者关系这里附上整套体系架构图与执行时序图。Harness 三大构件架构关系图AI 开发任务完整闭环时序图需求下发后架构、开发、测试、评审、运维各岗位读取 Rules、按岗位调用 Skills再闭环交付。