办事助手说明

办事助手是 XRK 运行时里的对话 Agent：在群聊、控制台或 stdin 里查资料、写文稿、整理表格、管理工作区文件。
种子在 agents/ + .xrk/skills/；运行时用 data/ai-workspace/{id}/（首次从种子复制，之后以工作区为准）。

相关文档

调办事助手行为：工作区或 agents/ + .xrk/skills/ 种子（见「想改助手行为时」）。
写框架 / Core：根 AGENTS.md。
一次 Agent 跑通、消息三层、Workspace/rules/skills 注入：见 agent-context.md（工程契约真源）。

上下文怎么进模型（摘要）

完整链路与代码落点见 agent-context.md。运营侧只需记住：

工具并集：ai_config.mergeWorkflows（开放模式可并入 web/browser；remote-mcp.* 须显式列入）。

能做什么

助手先匹配技能，再调用 MCP 工具。工作范围是当前工作区文件与通道工具。

怎么用

在哪里说话

• 群聊 / QQ 机器人：@ 或按群规则触发；短问短答、纪要、提醒。
• 控制台 / stdin：长任务、连续改稿、批量整理工作区。
• HTTP / 设备通道：见各产品 Core 说明。

斜杠与配方

• /recipes：列出可用配方
• /recipe <id> [k=v …]：注入该配方的 instructions + prompt（种子在 agents/recipes/）
• 需已触发助手（@ / 前缀等）；配方 cron 见配置 recipes.scheduleEnabled（默认关，开启后插件默认只打日志）

主人命令：#skills更新（托管包按种子覆盖；用户自建 skills/ 不动）。

危险命令审批（可选）

默认：security.approval.enabled=false，危险/策略 ask 直接拒绝（主人调用可放行）。
开启后主人私聊回复 #批准 / #批准id（空格可选）；插件 tool-approval。

工作区文件工具（摘）

合并 tools 时可用：repo_map（陌生仓定位）、apply_edit / verify（批量改与校验）、update_todos（多步待办）。全表见技能 agent-tools 或 mcp-guide.md。

工作区

日常改 data/ai-workspace/{id}/。更新所有人默认模板时改仓库 agents/ + .xrk/skills/ 种子。

想改助手行为时

技能类别

技能是办事手册；对话里有 <available_skills>，按需 read 对应 SKILL.md（每任务约 1–3 个）。

自建/商店装到 data/ai-workspace/{id}/skills/（SkillHub：skillhub install <名> --dir <该目录>，见 skillhub 安装说明 · agent-skillhub）。SKILL 写法见 agent-build-skill；工作区 Core 业务见 agent-core-dev（core/workspace-Core/，可导航读 .cursor/skills/xrk-*）。路由表：.xrk/skills/core/agent-core/SKILL.md。

Agents 清单

subagents.yaml 把办事角色写成注入提示，供模型路由。

工作区根目录的 subagents.yaml 优先于 agents/subagents.yaml。

改工作区文件

实现：src/utils/base-tools.js、core/system-Core/workflow/tools.js（增强：apply-edit-blocks.js、repo-map-lite.js）。

隐私与确认

• 密钥、token、身份证号等不进记忆或群聊；.env 不当普通文稿改。
• 删除文件、对外发送、本机执行命令前：说明影响并征得确认。
• 未核实数据标「待核实」。
• 群聊：被 @、被提问、或能给出可执行价值时再回复。

实现索引（维护者）

Prompt 注入顺序与 include* 门控：见 agent-context.md；实现 agent-workspace.js、ai-workflow.yaml。