关于 autonomous-agent-patterns
autonomous-agent-patterns 是用于设计自主编码 Agent 的技能,灵感来自 Cline 和 OpenAI Codex,面向构建 Agent 的开发者。它涉及工具 API、权限、浏览器自动化和人工审批,并强调示例只是概念片段,不能直接运行或构成安全边界。
主要功能
- 01设计自主编码 Agent
- 02规划工具与函数调用 API
- 03实现权限和审批机制
- 04设计浏览器自动化
- 05构建人工参与的工作流
- 06审视安全与验证要求
适用场景
- 01规划自主编码 Agent
- 02设计工具操作审批机制
- 03开发 Agent 浏览器自动化
- 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、工具、浏览器或生成的服务。