TODO
仓库未发布带版本号的 Release，此处记录最近一次更新日期。请查看提交历史了解变更。
开源项目已核验
智能体架构设计实践
一个不绑定厂商的技能，用于设计、审计和重构智能体运行框架，也能为新项目产出最小可行的架构蓝图。
2132收藏DenisSergeevitch作者TODO版本MIT许可证
Skill 概览
它遵循一条核心原则：模型负责提出动作，运行框架负责校验、授权、执行、记录并返回观测结果。围绕这条分工，这个技能可以帮你从零设计一个智能体运行框架，也可以审计现有实现、指出边界模糊的地方，或者解释某个框架为什么这么设计。适用范围不限于编程代理——研究、客服、运营、销售、财务、数据分析、采购、法务、医疗和教育场景下的智能体，都需要同一套运行时纪律。安装方式与厂商无关，Codex 和 Claude Code 都可以使用。
核心功能
- 明确区分模型职责与运行框架职责
- 支持从零设计，也支持审计和重构现有实现
- 可生成最小可行的架构蓝图
- 适用于编程之外的各类业务智能体
- 与厂商无关，多种代理环境通用
适用场景
- 准备自建智能体运行框架，需要先想清楚职责边界
- 现有实现出过越权或漏记录的问题，需要一次审计
- 要向团队解释某个框架的设计取舍
- 非编程场景的智能体，需要同样的运行时约束
安装方式
bash
npx skills add DenisSergeevitch/agents-best-practices -g使用说明
安装后，向代理说明你的目标即可：要设计新框架就描述业务场景和约束，要审计就把现有实现交给它，要解释就指定目标框架。全局安装后每个项目都能发现这个技能。
示例工作流
- 全局安装技能
- 说明目标：设计、审计、重构还是解释
- 提供业务场景、约束或现有实现
- 依据「模型提议、框架执行」这条原则审阅产出
- 按建议调整职责边界与记录方式
更新记录
常见问题
只适合做编程代理吗？
不是。仓库明确说明它同样适用于研究、客服、运营、销售、财务、数据分析、采购、法务、医疗和教育等场景的智能体，因为这些场景需要相同的运行时纪律。
「模型提议、框架执行」具体指什么？
指模型只负责提出要做什么，而校验参数、判断是否有权限、真正执行、留下记录并把结果返回给模型，这些都由运行框架承担。职责混在一起时，越权和漏记录就容易发生。