agents-best-practices
活跃·★ 2.4k·MIT·更新于 2026-10-19
★ 时下流行
agents-best-practices 是一个与模型提供方无关的 Agent Skill(一个 SKILL.md 加参考文档),帮助 AI 助手设计、审计、重构和讲解智能体运行框架(harness)。核心观点就是开头那句引文:模型提出动作,由运行框架负责校验、授权、执行、记录并返回观察结果。README 说它不局限于编码智能体,也适用于调研、客服、运营、财务、数据分析等工作流智能体。
技能涵盖模型—工具—观察循环、窄而有类型的工具与结构化结果、模型之外的权限检查、规划模式和需审批的执行、带预算和停止规则的目标循环、上下文与记忆、技能与 MCP 连接器的治理、考虑提示词缓存的布局、可观测性、评测和上线门槛。README 展示了三个用法:生成 MVP 方案(示例是需审批的续约风险智能体,给出最小工具清单和上线门槛:20 个历史客户、人工采纳率至少 80%)、审计现有的运行框架、设计工具和权限。它也明确说了自己不是什么:不只面向编码智能体,默认不是多智能体框架,也不能代替运行时授权或沙箱。用 `npx skills add DenisSergeevitch/agents-best-practices -g` 安装,或克隆到 Codex 或 Claude Code 的 skills 目录。许可证为 MIT。
#Agent 技巧#Agent 技巧集#Agentic 工作流#智能体#AI Agents#Anthropic#Claude#Claude Code
01
功能特性
01兼容 OpenAI、Anthropic 及兼容 API 的中立 Agentic 循环设计
02结构化类型工具定义,配合模型外运行时权限检查
03规划模式与审批门控执行模式,保障 Agent 操作安全
04上下文管理、记忆与自动压缩,保留活跃状态
05可观测性、评估、上线门控与事件响应清单
02
为什么选择它
+关注模型周围的“控制面”:校验、权限、审批、预算和审计
+有具体的示例,包含最小工具清单和可量化的上线门槛
+与模型提供方无关,一条 `npx skills add` 命令或直接克隆就能安装
+有清晰的“它不是什么”一节,并建议先从单智能体 MVP 做起
03
权衡点
!它是给助手参考的指导,不是库或运行时,运行框架仍需要你自己搭建并做好安全
!这些建议是作者个人的归纳,需要结合你自己的要求来取舍
!README 说明它不能代替运行时授权、沙箱和审计日志
!效果取决于你的助手对技能参考文档的遵循程度
04
维护状况检查
活跃检查日期: 2026-10-26
- 最近提交
- 2026-10-19
- 近 90 天提交数
- 17
- 近 90 天发布数
- 0
- 最新发布
- —
- 未关闭 issue
- 7
- 近期 issue 至少有一条评论的比例
- 1/6
近 12 周每周提交数
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #11 Responses API continuation example drops instructions after the first tool call0 条评论 · 2026-10-02
- #10 Please add missing Codex and Claude plugin definitions0 条评论 · 2026-08-24
- #2 SKILL.md inlines a blueprint template that duplicates references/mvp-agent-blueprint.md0 条评论 · 2026-05-16
- #1 SKILL.md inlines source links that duplicate references/source-links.md0 条评论 · 2026-05-16
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
05
兼容性
Claude Code
原生支持
已通过文档验证
Codex
原生支持
已通过文档验证
OpenAI API
支持
已通过文档验证
Anthropic API
原生支持
已通过文档验证
06
快速开始
1
$ npx skills add DenisSergeevitch/agents-best-practices -g
07
使用场景
↳为任意业务域(CRM、运营、金融、医疗等)生成 MVP Agent 框架蓝图
↳审计并重构脆弱或权限过宽的现有 Agent 系统
↳为多系统 Agent 设计窄域工具与连接器治理方案
08
同类工具
评论
登录后发表评论
暂无评论,来发表第一条吧