📌 Skill基础信息
- Skill名称:agentica
- 简称:agentica
- 来源:社区第三方(作者:shibing624)
- 运行宿主:Claude-Code CLI(基于 MCP 协议)
- 核心定位:构建能够长时间运行(小时级别)的 AI Agent,提供异步优先的 Python 框架,支持自动上下文压缩、成本预算控制、防死循环保护、跨会话持久化记忆和自我演进的 Skill 文档。
🧩 内部核心组成
agentica 是一个综合性 AI Agent 开发框架,其核心组成包括:
- 子Agent集合:支持多模型协作,可配置 20+ 模型接入
- 斜杠命令:内置
/goal长任务循环命令,支持复杂任务分解与执行 - MCP工具:集成 40+ 工具,涵盖常用开发、文件操作和网络功能
- 模板文件:提供标准 Agent 开发模板和配置示例
- Hooks钩子:支持生命周期事件钩子,用于自定义行为注入
- 规则约束:内置成本预算控制、执行时间限制和防死循环机制
- 目录结构:标准化项目结构,包含 skills, models, tools, memory 等模块
主要命令/工具表格:
| 命令/工具名 | 功能简述 |
|---|---|
| /goal | 长周期任务执行循环 |
| /budget | 设置成本预算控制 |
| /memory | 跨会话记忆管理 |
| /compact | 自动上下文压缩 |
| file_ops | 文件操作工具集 |
| web_tools | 网络请求工具组 |
| code_tools | 代码分析与执行工具 |
🛠 安装与启用方式
关键步骤:
- 通过官方技能库安装:
skills install --user shibing624/agentica - 确保运行环境:Python 3.8+ 和 Claude-Code CLI
- 前置依赖:异步运行时环境和支持长连接的 MCP 宿主
启动方式:
安装后通过 Claude-Code CLI 自动识别并加载,使用 /agentica 或相关命令触发。
📋 标准工作流
- 用户输入:通过
/goal命令定义长周期任务目标 - 任务分解:Agent 自动将复杂任务分解为可执行子任务
- 工具调用:按需调用 40+ 工具集中的相应工具
- 上下文管理:自动进行上下文压缩,维持有效对话历史
- 记忆持久化:重要信息保存到跨会话记忆系统
- 循环执行:持续执行直到任务完成或达到终止条件
- 结果输出:生成结构化结果并更新 Skill 文档
⚠️ 关键限制、缺陷、注意事项
- 平台限制:仅支持 Claude-Code CLI 环境,不支持其他 Agent 平台
- 资源消耗:长时间运行消耗大量 token,需要设置预算控制
- 项目适配:适合复杂长周期任务,不适合简单一次性查询
- 生产环境:社区版本,建议在测试环境充分验证后再上生产
- 已知坑点:异步操作需要正确处理并发,内存管理需注意
- 模型依赖:依赖外部模型 API,需要稳定的网络连接
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景:
- 需要长时间运行的复杂任务自动化
- 多步骤工作流需要跨会话记忆保持
- 开发需要成本控制和防死循环的可靠 Agent
- 研究型项目或概念验证开发
❌ 不适合场景:
- 简单问答或一次性查询任务
- 对响应延迟要求极高的实时应用
- 无 Python 环境或 Claude-Code CLI 支持的平台
- 资源受限的嵌入式或边缘计算场景
如何安装
skills install --user shibing624/agentica通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)
桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。
Claude Code(终端 CLI)
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。
VS Code(含 GitHub Copilot)
打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。
Windsurf
底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。
其他工具(ChatGPT、本地脚本等)
不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。
Aitishiku.com