mcpField
A
autonomous-agent-patterns

autonomous-agent-patterns

github.com/sickn33Agent 工作流48.7k967 次安装今天更新
代码仓库

关于 autonomous-agent-patterns

autonomous-agent-patterns 是用于设计自主编码 Agent 的技能,灵感来自 Cline 和 OpenAI Codex,面向构建 Agent 的开发者。它涉及工具 API、权限、浏览器自动化和人工审批,并强调示例只是概念片段,不能直接运行或构成安全边界。

主要功能

  1. 01设计自主编码 Agent
  2. 02规划工具与函数调用 API
  3. 03实现权限和审批机制
  4. 04设计浏览器自动化
  5. 05构建人工参与的工作流
  6. 06审视安全与验证要求

适用场景

  1. 01规划自主编码 Agent
  2. 02设计工具操作审批机制
  3. 03开发 Agent 浏览器自动化
  4. 04审查文件、网络和进程边界

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill autonomous-agent-patterns

安装后在 Claude Code 中输入/autonomous-agent-patterns确认已加载。

附带文件references/detailed-guide.md

详细介绍

🕹️ 自主 Agent 模式

构建自主编码 Agent 的设计模式,灵感来自 Cline 和 OpenAI Codex。

详细指南

执行此技能前,请阅读详细指南。其中保留了完整流程和参考资料。必须遵守其中的安全要求、前置条件和验证要求。针对特定任务,请加载相关章节;端到端完成任务时,请通读整份指南。

何时使用此技能

在以下情况下使用此技能:

  • 构建自主 AI Agent
  • 设计工具/函数调用 API
  • 实现权限和审批系统
  • 为 Agent 创建浏览器自动化
  • 设计人在环工作流

局限性

  • 仅当任务明确符合上述范围时,才使用此技能。
  • 不要将输出视为环境特定验证、测试或专家审查的替代品。
  • 如果缺少必需的输入、权限、安全边界或成功标准,请停止并请求澄清。

授权和实现限制

这些类是概念性片段,缺少导入项/类型/适配器/辅助函数,并非可运行的 Cline/Codex/MCP 实现。response.to_history_message 是需要针对实际提供方实现的适配器契约,并非标准 SDK 方法。MCP 客户端需要实际的传输/会话和生命周期;Server(config) 示例并非有效的客户端握手。生成的服务代码在审查前应保持惰性,不得运行。

按工具名称进行会话审批会授予过于宽泛的权限:应将授权绑定到具体操作、目标、数据和限制,并在授权范围内复用用户现有授权。读取工具可能暴露机密,而 npm/python/node/git 可能执行任意代码;将它们的名称加入允许列表或设置 cwd/HOME 并不能形成沙箱。必须在模型控制范围之外强制执行文件系统/网络/进程边界,拒绝路径逃逸/符号链接路径,验证架构,并为所有工具/LLM 调用和输出设置预算。审批 UI 和子串命令检查本身无法构成安全边界。

文件编辑需要进行原始内容冲突检查并安全地原子替换;检查点需要经过验证的会话 ID、私有原子文件,以及真实的工作区快照/恢复策略。仅凭 Git 状态/引用无法恢复未提交的内容。应限制文件大小/上下文,排除凭据,并将外部内容标记为不可信数据。浏览器 TreeWalker 文本既不是无障碍树,也无法保证是可见文本;networkidle 和近似坐标不能证明操作正确。应使用当前观察到的 UI 目标并验证结果。审查期间未运行任何 Agent、工具、浏览器或生成的服务。

评论

支持 Markdown