Skip to content

Skills in Channels and DMs: / invocation, Project Skills and bot-installed skills #4231

Open
1 of 8 issues completed

Description

@DoodleBears

Parent: 无(独立 hub)

背景

用户反馈:DSH 原生会话里可以用 / 触发 skill,但在 Bot 的频道和 DM 里不行。本 hub 让 Human 在频道/DM 里用 / 调用 skill,并让 PersonaBot 拥有、安装和展示自己的 skill。

已定设计(grilling 结论)

  • 词汇(已写进 GLOSSARY.md / GLOSSARY.zh.md 的 Skills 一节):
    • Host Skill:Host 用户级,所有 Session 可见。
    • Project Skill:某个目录 .agents/skills/ 下的 skill;目录是 PersonaBot 的 Memory Repository,或 Workspace Grant 覆盖的文件夹。PersonaBot 的 skill 就是其 Memory Repository 的 Project Skill,不另立 "Bot Skill"。
    • Skill Invocation:消息里的 skill chip,插入 skill 文本,不指向任何人。
  • ADR:ADR-0345(Project Skills travel with their directory)、ADR-0346(Skill Invocation is snapshotted text that addresses no one),随 S1 PR feat: invoke a Bot's Skills from / in a Human DM #4252 提交(草稿编号 0341/0342 因冲突重编号)。
  • 发现:Orchestrator 的 cwd 就是 Memory Repository,DSH 原生扫描 <root>/.agents/skills,并让它覆盖同名 Host Skill。Workspace 只扫授权根目录本身,不往上找 git 根。
  • 模型自动发现 = Host + 自己的 Memory Repository;Workspace skill 只在对应 Assignment 中原生可见。
  • / 菜单:先命令后 skill;来源 = Host + 对话中所有 bot 的 Memory Repository 与授权 Workspace(DM 只算这个 bot)。每行显示来源(bot 头像 / 文件夹 / Host 标识)、名称、单行描述(省略)。排序复用 rankByName:名称前缀 > 名称子序列 > bot 名命中 > 描述子串。上下键选择,像 @ 一样插入 chip。
  • 选中 skill 不隐式 @ 任何 bot;由谁执行只看 mention 和正常路由。命令与 skill 重名时裸名归命令。
  • 发送时 Host 解析并快照 {name, owner: host|bot:<slug>|workspace:<name>, path, content} 进 ChannelMessage;Bot Inbox 渲染为 <skill_invocation owner path>;外部 IM 降级为 /name。无授权的接收方只拿到文本,文件读取由 ADR-0067 守卫。
  • 安装 = 写文件。bot 自己判断装到 Memory Repository(bot 能力)还是 Workspace(项目约定,需写授权)。不单独记 activity,git 历史即记录;Human 只删除不禁用。
  • 分享:skill 随 Memory 仓库 / Bot Zip / Profile Backup 走;在新 Host 上随 Memory 一起直接生效,不单独审阅(Human 决定,见 Skills S7: review imported Project Skills before they activate #4238 与 ADR-0345)。

切片(按顺序)

S1 → S2 → S3 → S4 → S5 → S6 → S8(S7 不做,见 #4238),见下方 sub-issues。S1 完成后先给 Human 试用,再扩展。

Metadata

Metadata

Assignees

No one assigned

    Labels

    feature:channelChannel chat, timeline, composer, and navigationscope:hubParent coordination map or epic; not a standalone implementation slice

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions