memory-ci-capture

Memory CI Capture

Memory CI Capture 是一个内部 CI 技能，用于将一次有意义的 GitHub 交付时刻转化为项目记忆。它的定位是：GitHub 记录机制性的内容，而 Basic Memory 记住改变了什么以及为什么改变。

用途

该技能用于在 CI 流程中把 GitHub 交付上下文合成为 Basic Memory 的项目更新。它应在 bm ci collect 之后使用，返回值仅用于 bm ci publish。

输入

读取由 bm ci collect 生成、位于 .github/basic-memory/project-update-context.json 的 ProjectUpdateContext JSON。该上下文被视为以下事实的不可变来源：仓库、事件类型、PR 编号、工作流运行、SHA、源 URL、时间戳以及部署环境。

不得编造测试、部署检查、关联 issue、产品影响或决策。如果证据缺失，应在 verification 中简要说明，或将该字段留空。

输出

仅返回符合 AgentSynthesis 结构的 JSON：

{
  "summary": "What changed.",
  "why_it_matters": "Why this update matters for future humans and agents.",
  "user_facing_changes": [],
  "internal_changes": [],
  "verification": [],
  "follow_ups": [],
  "decision_candidates": [],
  "task_candidates": []
}

合成规则

• 优先给出简短说明，而不是逐提交的变更日志。
• 保留意图、变更后的行为、源链接、上下文中存在的验证证据以及具体的后续事项。
• 只有当源上下文中明确包含产品或架构决策时，才将其放入 decision_candidates。
• 只有当未来工作足够具体、可以行动时，才将其放入 task_candidates。
• 保持事实性和有用性。这是项目记忆，不是营销文案。

事件指引

对于已合并的 pull request，重点关注该 PR 为何存在、改变了哪个区域、推进或关闭了哪些 issue，以及上下文中出现了哪些验证证据。

对于生产部署，重点关注什么进入了生产、部署的 SHA、环境、工作流运行以及验证证据。不要超出工作流和源事实去过度声称成功。

使用方式

在运行 bm ci collect 之后调用本技能，读取 .github/basic-memory/project-update-context.json，按上述结构输出 JSON，并将结果交给 bm ci publish。

适用场景

适用于在 CI 中捕捉已合并的 pull request、生产部署等 GitHub 交付事件，并将其固化为 Basic Memory 项目更新。

限制

输入被视为不可变事实来源，不得编造测试、部署检查、关联 issue、产品影响或决策。文档未提供该技能的独立安装命令、收费方式、支持的平台或效果说明，这些信息暂未提供。