Skip to content

feat: agent 集成改为 skill 承载,生成标准 SKILL.md 并移除 hooks - #1

Merged
MickLife merged 1 commit into
developfrom
feat/agent-skill-integration
Aug 20, 2026
Merged

MickLife merged 1 commit into
developfrom
feat/agent-skill-integration

Conversation

@MickLife

Copy link
Copy Markdown
Owner

背景

meX 记忆系统需要接入通用 agent。原方案(ADR-12)依赖"会话结束 hook 兜底写 + skill 管读写",
但核实 OpenCode 官方配置 schema 没有 hooks 字段(原生不支持 Claude Code 风格的生命周期 hook),
原生成物(hooks.md + 平铺 skill.md)在 OpenCode 上不生效。经与用户确认:不用 MCP,改用 skill 承载,
移除 hooks,写作原则参考 prompts.py 提炼。

改动

  • integrate 生成物重构:claude/opencode 从三件套(hooks.md/skill.md/README.md 平铺)
    改为官方发现路径 skills/mex/SKILL.md + 根目录 README(skills/ 为复数,Claude Code / OpenCode 官方约定)。
  • SKILL.md 标准化:补 YAML frontmatter(name: mex + description,缺失则无法被 agent 加载);
    正文教 agent 六件事——对话开始 mex profile、时敏召回 mex search --since、定向检索
    mex search --topic、即时写 mex extract/mex add、不频繁写、写作原则
    (具体/独立/有用/不重复、时间写具体日期、画像 vs 画像外、名称用全称,提炼自 prompts.py 质量标准 + dsh 写作规范)。
  • 移除 hooks.md(claude + opencode):OpenCode 无原生 SessionEnd hook,写路径由 skill 引导即时写承担,
    hook 能力留待后续扩展。
  • CLI 提示更新:mex integrate 的 Next steps 指向官方 skill 路径。
  • 架构文档同步:ADR-12 修订为"skill 承载读写、hook 留待扩展",§8 各节(8.1 时机表/8.4 生成内容/8.5 要点)与命令表、安装方式同步。
  • .gitignore:追加 .workbuddy/(工具数据目录,含隐私日志,不入库)。

验证

  • ruff check 通过
  • 完整测试套件 569 全绿(tests/cli/test_integrate.py、tests/services/test_integrate.py 已按新布局更新)
  • 真实冒烟:mex integrate opencode --scope project 生成 ./.opencode/skills/mex/SKILL.md
    (frontmatter 正确、{{MEX_HOME}}/{{DB_PATH}} 占位符全部替换)+ README

说明

  • 本 PR 未做 MCP(用户明确不做);架构文档 P3-6 的"MCP 服务薄封装"远期条目保留未动,待用户决定是否移除。
  • 用户本地若跑过旧版 mex integrate opencode,需清理旧的 hooks.md/skill.md 平铺文件后重新生成。

- integrate 生成物从三件套改为 skills/mex/SKILL.md + README
  (官方 skills/ 复数发现路径,claude 与 opencode 同步)
- SKILL.md 补 YAML frontmatter(name+description),正文教 agent 用
  mex CLI 读写记忆,写作原则提炼自 prompts.py 质量标准
- 移除 hooks.md:OpenCode 官方配置 schema 无 hooks 字段,原生不支持
  SessionEnd hook,写路径由 skill 引导即时写承担,hook 留待扩展
- cli integrate 的 Next steps 改为指向官方 skill 路径
- 架构文档 ADR-12/§8 同步修订(skill 承载读写、hook 暂缓)
- .gitignore 忽略 .workbuddy/(工具数据目录,含隐私)
@MickLife MickLife self-assigned this Aug 20, 2026
@MickLife
MickLife merged commit dc51493 into develop Aug 20, 2026
1 check passed
MickLife added a commit that referenced this pull request Aug 20, 2026
* docs: 同步 workbuddy 接入到 README 与架构文档

- README:支持列表加入 WorkBuddy;"与 agent 集成"章节补充
  mex integrate workbuddy 命令与对接文档链接;顺带修正过时的
  "hook 配置"文案(PR #1 起已改为 skill 承载)
- architecture.md §8.4:补 workbuddy 命令示例,说明其 skill 写入
  位置(base 即 skill 根目录,直接写 mex/SKILL.md)
- dsh-integration.md:§8 引用的 agent 列表加入 workbuddy

* Update dsh-integration.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant