智能体架构三件套:CLI、Harness 与状态机
① CLI(手) — 干活的。agent 调用它去执行具体动作:查排名、抓数据、改配置。结构化输入输出,exit code 清楚,错误信息机器可读。这是你现在已经在做的。但单独的 CLI 是哑的——它只会干,不知道"在你这儿该怎么干"。
② Harness(围栏) — 项目根目录里的那几个文件:
CLAUDE.md
/ AGENTS.md、hooks、路径保护、工具白名单。它规定 agent 在这个项目里的行为边界:哪些目录不许碰、改完必须跑什么验证、什么动作需要人确认。CLI 是"能干什么",harness 是"不许怎么干"。
③ 技能(经验包) —
SKILL.md
这种东西。harness 是禁止性的(别越界),技能是指导性的(这类活的正确干法)。比如一个"客户监控类工具怎么做"的技能:默认出七天趋势不出快照、报告格式长什么样、交付前自测哪几项。agent 接到这类任务,先读这个技能再动手。
④ 工作流(装配线) — 把上面三个串起来的自动化流程。它干的事:新项目接进来 → 扫一遍仓库 → 去库里把适用的约束捞出来 → 自动生成这个项目的 harness 和该挂载的技能 → 然后 agent 才开工。这就是你最早说的"Claude Code Workflow 自动生成 Harness"——它在组合里的位置就是这儿:harness 和技能不是你每个项目手写的,是工作流从库里编译出来的。
⑤ 库(踩坑本,中枢) — 上面四个零件都围着它转。它存的就是一条条结构化的经验/约束。
关联工程母题系统与实测说明:
本篇「智能体架构三件套:CLI、Harness 与状态机」由 qilai 整理收录于 qilaidav 工程知识库,围绕 企业协同与三库底座 (Spec/Prompt/Memory) 的生产环境架构设计、链路排障与确定性验证展开沉淀。完整系统模块、部署边界与技术规格请查阅方案主页:→ 查看 企业协同与三库底座 (Spec/Prompt/Memory) 详情(架构诊断与定制交流:Telegram @BD8888 · hello@qilaidav.com · GitHub @qilaidev)。
免责声明与评测方法:本文所涉开源工具、模型基准与工程配置均基于实测环境与公开技术资料整理,仅供系统架构研发参考,不构成任何商业背书或投资建议。
— qilai · 摘自 Telegram 频道 @AIKB8