ybrain — 个人外脑方法论层

以 CODE 循环（捕获→组织→提炼→表达）+ PARA 组织法管理 IMA 上的个人外脑。本技能自包含：运行所需的全部术语、规则与 API 文档均在本文件及 scripts/、references/ 内；设计共识文档（GLOSSARY、ADR）留存于开发仓库，仅为背景，运行时无需读取。

定位与硬边界

• 本技能完全自包含：方法论（本文件）+ 传输与工具脚本（scripts/）+ API 文档（references/），不依赖 ima-skills 或任何外部技能。
• 传输统一走 node "$SKILL_DIR/scripts/ima_api.cjs" <apiPath> <json-body>（$SKILL_DIR = 本技能目录；凭证自动从 ~/.config/ima 读取）。⛔ 禁止绕过它直接 curl 构造 IMA 请求。
• API 文档全部内置，调用前必读对应文件：
  • 通用规则（UTF-8 校验、文件上传安全门、错误码、URL 类型检测、get_media_info、MediaType 与大小限制）→ references/core-rules.md
  • 知识库扩展面（建库/建文件夹/移动/重命名/标签/浏览/定位）→ references/knowledge-base-{read,write,upload,tag}.md
  • 笔记面（读写/块编辑/笔记本管理/导出）→ references/notes.md（结构体与错误码全集见其 notes-api.md）
• 首次使用引导与最佳实践 → references/best-practices.md：Bootstrap 时、各工作流首次完成时、用户问「这技能怎么用/有什么用/怎么开始」时必读，按其「五步体验闭环」引导
• 删除仍不存在：无法删除知识库条目、文件夹、笔记、笔记本。判"不存"的条目一律移 4-存档；用户坚持删除时告知其在 IMA 客户端手动操作，不要构造或重试删除接口。
• export_media_for_ima_sandbox 当前凭证无权限（220030），禁止使用；知识库条目原文走 get_media_info 分支（references/core-rules.md），笔记原文用 export_note。
• 写操作不可逆。用户显式指令范围内的写入（"记一下"、"整理收件箱"确认后的归位）直接执行；范围外写入（新建知识包、重命名、tag_delete / tag_rename 等）必须先确认。
• 凭证缺失时立即停：IMA 调用报「未找到 IMA 凭证」（-100）→ 停止后续调用、不重试，引导用户到 https://ima.qq.com/agent-interface 获取 clientId / apiKey，协助写入 ~/.config/ima/client_id 与 ~/.config/ima/api_key（或设置 IMA_OPENAPI_CLIENTID / IMA_OPENAPI_APIKEY），就绪后从被打断的步骤继续。
• 操作知识库前用 search_knowledge_base 确认角色为创建者/协作成员/管理员；普通成员的库拒绝写操作。