Agent Harness：将 Harness 范式迁移到专业行业文章、深度调研报告撰写
不少读者提出疑问：Harness 工程体系换到不同行业写深度报告，是不是每次都要全部重构？通用写作规则和行业专业约束，该怎么共存？本篇重点讲清楚Harness的分层插件架构：通用构件作为基础骨架，行业专属构件作为可插拔插件，以及项目总览文件
AGENT.mdc的设计思路。
很多人用大模型生成行业调研报告，踩坑几乎是一致的。同样一套提示词，换到制造业、医药、法律不同领域，要么术语不专业、口径混乱，要么合规表述出错。如果直接把行业约束全部塞进Prompt，对话一旦重启，所有专业规则全部失效。
这里的核心认知是：Harness不是一次性Prompt，而是一套工程体系。它天然支持分层设计，通用构件负责文档生产的基础流水线，行业专属构件注入领域专业约束；二者叠加生效，而不是互相替代。 切换行业撰写报告，不需要推倒重建整套Harness，只需要替换行业插件。整套项目由AGENT.mdc作为总入口，统一定义项目目标、优先级与执行流程。
一、分层设计：通用构件与行业专属构件的边界
构件分为两层：常驻加载的通用基础层，按需加载的行业插件层。
通用构件，面向所有专业写作场景，解决文档体例、基础事实校验、通用文字加工问题；行业专属构件，针对单一领域，定义行业术语、指标口径、合规红线、领域数据解析能力。而**AGENT.mdc是整个Harness项目的总图文件，是所有Agent最先读取的全局配置**。
1. 通用构件（跨行业复用，一次编写，长期复用）
通用 Rules
它是所有行业报告共用的基础约束，只管文档生产通用底线，不涉及行业专业知识。
- 文档结构规则：深度报告固定章节顺序：摘要 → 行业背景 → 现状分析 → 痛点拆解 → 案例 → 趋势研判 → 风险提示 → 结论，不允许随意删减一级章节。
- 术语基础规则：缩写首次出现标注全称，同一概念全文名词统一。
- 事实红线：禁止编造统计数据，无溯源的数据不能写入正文，统一放入待核实清单。
- 行文约束：区分事实陈述和主观预判，禁止营销夸大话术。
- 引用规范：参考资料统一引用格式。
通用Rules的特点：写制造业、医药、法律报告，这一套基础规则基本不用改动。
通用 Skills
标准化、原子化的文档处理工序，属于通用工具箱。
- 资料精读Skill：批量读取文档，提取观点、关键数据，输出结构化素材库
- 摘要撰写Skill：基于素材库，按固定模板生成摘要，控制篇幅
- 章节生成Skill：读取素材，按照固定章节模板生成初稿
- 术语一致性校验Skill：扫描全文，检查名词前后是否冲突
- 事实溯源校验Skill：识别文中无来源断言，输出待核实清单
- 全文润色Skill：统一行文逻辑，不改动事实和核心结论
- 目录与交叉引用Skill：自动维护文档目录、章节之间引用关系
通用 Agents
角色分工固定，职责和行业无关。
- 素材研读Agent：读取原始参考资料，提炼结构化素材，不撰写正文
- 撰稿Agent：加载Rules、读取素材，调用Skills逐章节生成文稿
- 文稿质检Agent：独立角色，不参与初稿撰写，校验文档体例、引用、术语一致性
通用构件的价值：保证整条文档流水线稳定运行，解决格式、结构、基础事实校验问题。
2. 行业专属构件（可插拔插件，按领域单独维护）
这一层是区分不同行业报告质量的关键。切换行业时，只替换这部分内容。下面只举例制造业、医药、法律三个行业，每个行业都包含专属Rules、专属Skills、专属Agent。
① 制造业 专属构件
制造业专属Rules
- 术语规范：工艺、产线、设备、质量相关名词，采用国标术语；如良率、OEE、MTBF、CPK，不可自行改写定义。
- 指标口径：设备稼动率、良品率、报废成本，明确统计边界，区分理论值与现场实测值。
- 表述红线：不得随意推断设备故障根本原因；安全相关描述必须匹配安全生产规范。
- 数据约束：产能测算需要标注假设条件，不能省略前提直接给出预测产量。
制造业专属Skills
- 产线指标解析Skill：解析OEE、MTBF、CPK等质量与设备指标，核对计算公式
- 生产案例拆解Skill：提取产线停机、质量不良案例，结构化根因记录
- 制造工艺描述校验Skill：核对工艺流程描述，确认工序先后顺序无颠倒
制造业专属Agent：制造业务校验Agent
独立评审角色，只负责核查：工艺描述、设备指标口径、生产安全表述、工厂成本测算逻辑。不负责基础格式校验。
② 医药行业 专属构件
医药行业专属Rules
- 术语规则：疾病、药品、临床试验术语，严格遵循NMPA官方定义。
- 疗效红线：严禁夸大药效；必须严格区分临床试验原始数据、文献结论、市场观点，不能混为一谈。
- 隐私与合规：禁止虚构受试者个人信息；涉及临床试验结论，不能超出试验方案范围外推疗效。
- 报告约束：药品相关分析文稿，不得做出“治愈”“无副作用”这类绝对化表述。
医药行业专属Skills
- 临床试验数据提取解读Skill：解析入排标准、主要终点、不良事件信息，结构化整理试验结果
- 药品政策拆解Skill：解读NMPA审批、集采、医保相关政策条文
- 医学术语交叉校验Skill：核对适应症、给药方案、不良反应描述的专业准确性
医药行业专属Agent：医药合规校验Agent
独立评审角色，专项核查临床试验表述、药品宣传红线、监管合规风险，拦截夸大疗效、违规断言内容。
③ 法律行业 专属构件
法律行业专属Rules
- 术语规范：法条、案由、权利义务等名词，采用现行国内法律标准表述，不得自创法律概念。
- 法条引用规则：引用法条必须写明法条编号、版本；法条废止/修订状态必须标注。
- 风险红线：分析意见必须标注“本文仅为法律研究，不构成正式法律意见，不能作为诉讼代理依据”。
- 事实约束：不得虚构判例、虚构裁判文书内容；判例要标注案号与裁判法院。
法律行业专属Skills
- 法条检索与比对Skill：核对引用法条是否现行有效，识别已废止条文
- 判例信息结构化Skill：提取裁判要点、争议焦点、裁判结论
- 法律逻辑校验Skill：检查法律论证链条，识别逻辑跳跃、法律适用错误
法律行业专属Agent：法律文书校验Agent
独立评审角色，专门核查法条有效性、案由定性、法律论证、判例引用是否合规准确。
优先级约定：当行业Rules和通用Rules发生冲突时，行业Rules优先级更高，可以覆盖冲突的通用规则。该约定写在
AGENT.mdc项目总图中。
二、AGENT.mdc 总图文件的撰写思路
AGENT.mdc是整个Harness项目的总入口，是Cursor加载整套体系时，最先读取的文档。它不写具体Rules条款、不写Skill的实现细节，只定义全局信息。
AGENT.mdc 需要包含的内容
- 项目目标：本Harness用于产出XX行业深度调研报告、行业分析文章，说明文档受众、输出风格。
- 构件目录索引：列出本项目启用的通用构件、行业插件的文件路径，方便Agent自动检索。
- 规则优先级约定：明确行业Rules > 通用Rules，冲突时以行业规则为准。
- 完整流水线执行步骤（截图里的7步流程）：
1. 加载【通用Rules】，基础写作约束全局生效
2. 按需加载【行业专属Rules】，叠加领域专业、合规约束
> 两套规则合并，全部作为强制约束，行业规则优先级更高
3. 启动通用素材研读Agent，调用通用资料提取Skill读取参考文档
4. 遇到行业领域数据、专业内容，自动调用【行业专属Skill】，输出结构化领域素材
5. 撰稿Agent读取素材库，调用通用章节撰写Skill生成初稿，同时遵守两套Rules
6. 质检流水线分两级校验：
◎ 通用质检：调用通用质检Skills，校验文档结构、术语、引用来源
◎ 行业专项质检：调用行业Skills/行业专属Agent，校验专业口径、行业合规红线
7. 任意阻断级规则不满足，退回撰稿Agent自动修改；全部校验通过，输出终稿
- 可选配套Mermaid流程图，直观展示整个业务流转，Cursor可以直接渲染预览。
- 输出约定：产出文档格式、附件清单、需要附带的风险声明。
核心设计原则：
AGENT.mdc做调度和总览，把细节下沉到rules、skills、agents目录下的独立文件，实现关注点分离，方便单独修改、插拔行业插件。
三、整套流水线加载与执行顺序
1. 加载【通用Rules】，基础写作约束全局生效
2. 按需加载【行业专属Rules】，叠加领域专业、合规约束
> 两套规则合并，全部作为强制约束，行业规则优先级更高
3. 启动通用素材研读Agent，调用通用资料提取Skill读取参考文档
4. 遇到行业领域数据、专业内容，自动调用【行业专属Skill】，输出结构化领域素材
5. 撰稿Agent读取素材库，调用通用章节撰写Skill生成初稿，同时遵守两套Rules
6. 质检流水线分两级校验：
◎ 通用质检：调用通用质检Skills，校验文档结构、术语、引用来源
◎ 行业专项质检：调用行业Skills/行业专属Agent，校验专业口径、行业合规红线
7. 任意阻断级规则不满足，退回撰稿Agent自动修改；全部校验通过，输出终稿
这个执行顺序的核心好处：流水线主体完全不变，只插拔行业插件，极大降低多领域场景下维护成本。整套流程定义在AGENT.mdc，所有Agent统一遵循这套流程。
四、两种落地模式，按需选择
模式1：轻量模式（推荐绝大多数行业文章、调研报告场景）
不启用独立行业Agent，仅追加行业Rules + 行业Skills。
插件快速生成技巧：行业Rules、行业Skills不需要全部人工手写。可以直接将行业标准、专业文献丢入Cursor，由Cursor模型自动提取、生成对应的行业Rules与行业Skills初稿。
工作流程：上传行业规范/专业文献 → Cursor自动提炼术语、指标口径、合规红线，输出行业Rules初稿；再基于同一份资料，拆解领域专属工序，生成行业Skills初稿。
人工只负责审核、分级（阻断/警告/建议）、修正模型产生的专业错误，不用从零撰写全部构件，大幅降低搭建新行业Harness的成本。
适用场景：行业综述、政策解读、市场分析报告、竞品分析。
优势：改动最小，维护成本低。原有三套通用Agent角色不变，只增加领域规则与领域解析能力。
模式2：完整行业插件模式（高合规高风险领域）
在原有通用三角色之外，叠加独立行业专属Agent，作为独立评审关卡。
同样可以利用Cursor加速构件准备：上传行业法规、专业文献，自动产出行业Rules、行业Skills初稿；人工复核后，再编写行业专属Agent的角色定义文档。最后更新
AGENT.mdc，新增这个Agent的索引。
适用场景：医药临床分析报告、法律案例研究、制造业安全评估报告，专业错误代价高。
原有素材研读、撰稿、文稿质检Agent保留；新增行业Agent，只负责领域专业与合规校验，不校验排版、引用这类通用问题。
五、项目目录结构（可直接在Cursor使用，插件化组织）
report-harness/
├── AGENT.mdc # 项目总图：写作范围、读者定位、规则优先级、流水线流程
├── rules/
│ ├── common_rules.md # 通用写作规则，长期不变
│ └── industry/
│ ├── manufacturing_rules.md # 制造业专属规则
│ ├── medical_rules.md # 医药行业专属规则
│ └── legal_rules.md # 法律行业专属规则
├── skills/
│ ├── common/ # 通用技能，全场景复用
│ │ ├── material_extract.md
│ │ ├── chapter_write.md
│ │ └── fact_check.md
│ └── industry/ # 行业专属技能，可插拔插件
│ ├── manufacturing_index_parse.md
│ ├── clinical_data_analysis.md
│ ├── legal_case_extract.md
├── agents/
│ ├── material_reader.md # 通用：素材研读Agent
│ ├── report_writer.md # 通用：撰稿Agent
│ ├── report_reviewer.md # 通用：文稿质检Agent
│ └── industry/
│ ├── manufacturing_reviewer.md
│ ├── medical_compliance_reviewer.md
│ └── legal_document_reviewer.md
├── materials/ # 原始参考资料，用于生成行业Rules/Skills，同时作为报告写作素材
└── output/ # 输出初稿、质检报告、终稿
六、落地踩坑清单
- 将行业特有约束写入通用Rules
问题：通用Rules不断膨胀，跨行业复用失效。
方案：通用Rules只放全场景通用约束；领域特有规则，统一放到industry目录下独立维护。
- 规则冲突，没有定义优先级
例如通用规则要求摘要300字，医药行业监管文档要求摘要不少于500字。
方案：在AGENT.mdc明确约定：行业Rules优先级高于通用Rules，解决冲突。
- 直接采信Cursor自动生成的Rules、Skills，跳过人工审核
问题：模型阅读专业文献时容易错读条款、误解指标口径，自动生成的构件会自带专业错误。
方案：Cursor仅用来生成初稿；行业专家必须复核，区分阻断级红线、警告项，修正专业偏差，不能直接上线。
- 行业Rules堆砌过多细节，行文僵硬
方案：区分阻断级红线、警告、优化建议。只有合规、专业口径类问题设置为阻断；文风细节设置为警告，不阻断交付。
- 过度依赖行业Skills，期待Agent产出原创洞见
提醒：Skills只能做结构化提取、指标解析、格式校验。核心行业观点、业务判断，仍然需要人来定义。Harness负责稳定产出合规文稿，不替代人的专业洞察。
- 行业质检Agent和撰稿Agent共用上下文，自检失效
方案：行业专属Agent必须独立会话，不共享撰稿阶段的推理上下文，保证评审客观性。
- AGENT.mdc写得过于冗长，混入大量细节规则
问题：总图文件信息过载，Agent读取时容易丢失重点。
方案：AGENT.mdc只保留目标、流程、索引、优先级，详细规则和能力描述拆分到独立rules/skills/agents文件。
七、适用边界
✅ 适合：制造业行业分析、医药产业研究、法律案例深度分析、政策解读文稿、竞品分析、系列专业专栏。
⚠️ 辅助场景：原创深度论文，Agent负责资料整理、初稿撰写、校对；核心论点由人确定。
❌ 不适合：缺少参考素材，需要突破性原创科研结论、正式法律意见书、临床诊断报告场景。
八、总结
Harness范式迁移到专业文稿撰写，核心就是这套插件化分层架构。
通用构件是文档生产流水线的骨架，跨行业直接复用；行业专属构件是可插拔插件，用来注入领域术语、指标口径、行业合规约束。而AGENT.mdc作为项目总总图，定义全局目标、规则优先级与完整执行流水线，作为整套Harness体系的入口。
搭建行业插件也不需要完全手工编写。把行业标准、专业文献导入Cursor，模型可以快速生成行业Rules、行业Skills的初稿，再由人工校验修正。大幅降低新增行业Harness的落地成本。
当我们切换制造业、医药、法律不同行业撰写报告，不需要重建整套Harness体系，只替换行业层插件。
创作者不再反复调试Prompt、逐字校对术语与专业口径。人的精力聚焦在选题、划定研究边界、定义核心观点，最终验收文稿。整套流水线负责稳定产出体例统一、专业口径合规的行业文章与调研报告。
397
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
