Aitishiku.com📌 Skill基础信息
Skill名称：honcho-integration
简称：Honcho 集成工具
来源：社区第三方（x402agent）
运行宿主：Claude-Code CLI
核心定位：将 Honcho 记忆与社交认知能力集成到现有 Python 或 TypeScript 代码库中，为 AI 智能体添加上下文感知和用户建模能力。
🧩 内部核心组成
子Agent集合
【无公开信息】
斜杠命令
【无公开信息】
MCP工具
该 Skill 使用以下 MCP 工具进行代码库分析和交互：
| 工具名称 | 功能简述 |
|---|---|
| Read | 读取代码文件内容 |
| Glob | 全局文件模式匹配 |
| Grep | 文本搜索和模式匹配 |
| Bash(uv:*) | 执行 Python 包管理命令 |
| Bash(bun:*) | 执行 TypeScript 包管理命令 |
| Bash(npm:*) | 执行 Node.js 包管理命令 |
| Edit | 编辑代码文件 |
| Write | 写入新文件内容 |
| WebFetch | 从网络获取资源 |
| AskUserQuestion | 向用户提问获取配置信息 |
模板文件
【无公开信息】
Hooks钩子
【无公开信息】
规则约束
- 必须遵循四阶段集成工作流：代码库探索 → 用户访谈 → 实现 → 验证
- 所有实体必须创建对应的 Honcho Peer
- AI 助手必须设置
observe_me=False
目录结构
【无公开信息】
🛠 安装与启用方式
安装命令：
skills install --user x402agent/SolanaOS前置依赖：
- Honcho API 密钥（从 https://app.honcho.dev 获取）
- 现有 Python 或 TypeScript 代码库
包管理依赖：
- Python 项目：uv 包管理器
- TypeScript 项目：bun 或 npm 包管理器
启动方式：在 Claude-Code CLI 中自动启用该 Skill
📋 标准工作流
- 代码库探索阶段：自动扫描代码结构，识别语言框架、现有 AI 集成、实体结构和会话处理机制
- 用户访谈阶段：通过交互式提问确定：
- 需要跟踪的实体类型（用户、AI 助手等）
- 集成模式选择（工具调用、预获取、上下文注入）
- 会话结构映射方式
- 特定上下文查询需求
- 实现阶段：
- 安装 Honcho SDK（Python：honcho-ai，TypeScript：@honcho-ai/sdk）
- 初始化 Honcho 客户端
- 为所有实体创建 Peer
- 配置多参与者会话
- 实现消息存储逻辑
- 更新现有对话处理器
- 验证阶段：
- 确保所有消息交换正确存储
- 验证 AI Peer 观察设置
- 检查工作区 ID 一致性
- 确认 API 密钥环境变量配置
⚠️ 关键限制、缺陷、注意事项
平台限制：
- 仅支持 Python 和 TypeScript 代码库
- 需要现有 AI/LLM 集成基础
Token 消耗：
- Honcho 异步处理消息会产生额外计算成本
- 查询操作消耗 API 调用额度
适用项目类型：
- 已有聊天功能的应用程序
- 需要用户个性化服务的 AI 助手
- 多参与者对话系统
不适用场景：
- 无状态或一次性交互应用
- 对延迟极其敏感的场景
- 没有用户对话历史的应用
已知坑点：
- 必须正确设置
observe_me=False避免对 AI 建模 - 工作区 ID 需要在全代码库保持一致
- 异步/同步客户端需要匹配框架类型
生产环境就绪：社区版本，建议充分测试后再上生产环境
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景：
- 已有 FastAPI、Express、Next.js 等框架的聊天应用
- 需要为用户添加长期记忆能力的 AI 助手
- 多 AI 代理协作系统（nanobot、openclaw 等框架）
- 需要理解用户偏好和背景的个性化服务
❌ 不适合场景：
- 静态内容网站或无用户交互应用
- 对响应延迟要求极低的实时系统
- 没有现有代码基础的新项目
- 仅需要简单对话无需用户建模的场景
如何安装
skills install --user x402agent/SolanaOS通用安装教程：在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 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 的能力让其调用；不同工具的命令格式请以其官方文档为准。
风险提示
本 Skill 涉及读取隐私 / 敏感信息（如密钥、环境变量、凭据）。安装前请确认其用途是否必要。
检测到隐私/敏感信息读取（预设模式 #3） 检测到隐私/敏感信息读取（预设模式 #6）
命中检测项
- privacy_collect