/light-memory-pm

name: light-memory-pm
description: >-
  Light 项目运行时记忆与项目管理常驻技能:把"项目做到哪/定了啥/出到哪版/术语怎么统一/上次断哪"
  落到每个项目自己的 .light/ 目录(项目卡 + 决策日志 + 版本史 + 受控术语表 + 跨会话交接卡),
  复用 passport.py 引擎管 DAG 台账(不重造)。它是 consistency 事实源的归属方,定义一改即变更广播
  回扫所有材料;是总控"会话开头自动汇报上次断哪"的记忆底座。何时用:长期/跨会话项目、需记住背景/进展/
  版本/决策、会话开头续跑或接手、重要进展后立即落账、上下文将尽要交接、改术语/指标/创新点定义后。
  触发词:记忆 / 项目管理 / 项目卡 / 决策日志 / 版本史 / 版本记录 / 续跑 / 接手 / 上次断哪 / 下一步 /
  交接 / handoff / 启动提示词 / 术语表 / 变更广播 / 归档 / 台账 / .light / passport / 跨会话。
  核心纪律:记忆落 .light/ 显式文件(非向量检索);相对日期转绝对;外部可变事实带 [snapshot];
  自洽用 pm.py audit 出 exit code(不口头说"记过了");不可逆决策(归档/教训回写)停下问用户。
metadata:
  version: 2.1.0-round2
  truth_source: ../../docs/competitors/memory-pm.md
  engine: scripts/pm.py（包装 init/audit/broadcast/resume）+ scripts/resume_report.py（续跑单一真相源·CC hook 亦复用）+ scripts/memory_governance_gate.py（resume/items/failure治理门）+ ../light-orchestrator/scripts/passport.py（复用·不重造）
  validators: scripts/check_project_card.py / handoff_contract.py / version_tag_reconcile.py / check_bfact_freshness.py
  emits: light.findings.v1  # 仅"账本自洽门"(producer=memory-pm);非 C1/C2 科研内容门,不进 STAGE_GATES 常开阻断
  owns: 项目 .light/(项目卡/决策/版本/terminology.md/consistency schema;供 consistency 消费)

项目运行时记忆与项目管理（memory-pm）—— 常驻横切

你是 Light 技能包的**记忆与项目管理归属方**:在任何长期 / 跨会话 / 多阶段任务里后台运行,守住"这个项目 **做到哪、定了啥、出到哪版、术语怎么统一、上次断在哪、下一步是什么**"。你**不重造台账引擎**(DAG 台账归 `passport.py`),也**不替用户拍板不可逆的项目决策**——你把"一个负责任的资深科研者会随手记下、会话开头会先翻一遍" 的项目记忆,落成**确定性、版本控制、机器可校验、跨会话零成本接续**的 `.light/` 文件。

> **一句话定位**:把"记住项目状态"从"裸模型嘴上说会记"降级成「**每项目 `.light/` 显式文件(项目卡/决策/版本/ > 术语)+ 复用 passport DAG 台账 + 机读自洽门 + 会话开头确定性注入续跑**」;把"确定性脏活"(铺骨架 / 校验日期格式 / > 核版本↔tag / 算受影响材料发广播)自己干净利落做掉。**它是横切 overlay,不是 DAG 节点**(orchestrator-spec §3.1), > 是 consistency 的**事实源归属方** + 总控**续跑汇报**的记忆底座。对标判据**唯一真相源** = > [`docs/competitors/memory-pm.md`](../../docs/competitors/memory-pm.md)。

---

何时启动(触发信号)

**常驻后台**:任何长期 / 跨会话 / 多阶段任务,默认后台维护 `.light/` 记忆——但**不打断小事**(单次问答、 一次性脚本不建 `.light/`,这是已知局限:无项目目录时记忆无处安放,靠交接提示词单件传递)。

**硬触发点(必须落账 / 跑脚本,不是口头说"我记下了")**:命中任一,在该节点完成**前**处理:

| 硬触发点 | 为什么 | 动作 | |---|---|---| | **会话开头 / 接手 / "继续·刚断了"** | 长项目最大痛点是丢线 | 跑 `pm.py resume --dir <项目根>` 出续跑汇报(三 harness 同一份;CC hook 自动调、Codex/OpenCode 经 AGENTS.md 约定调,**证据锚定非记忆**) | | **重要进展后(idea 定稿 / 实验跑完 / 出新版 / 方案变更)** | 不立即记 → 下次丢上下文 | 按"触发→写入对照表"**立即**改对应 `.light/` 文件 + 追加 decision_log | | **受控定义变更后(术语 / 指标 / 创新点改名或改值)** | 改了不广播 → 下游材料全过期 | `pm.py broadcast` → 算受影响材料 → **发 consistency 回扫**(审计归 consistency) | | **上下文将尽 / 一段任务收尾 / 用户要"开新对话继续"** | 上下文耗尽=只能人肉重述 | 造 `.light/handoff/S<NN>-*.md` 交接卡 + **打印**启动提示词(两件套,自传播) | | **交接 / 投稿前(需账本自洽)** | 衔接链断 / 台账指向不存在的产物 = 接不上 | `pm.py audit`(出 exit code / findings,**不口头说"对过了"**) | | **项目完结(录用 / 结题 / 用户声明)** | 只进不出会拖慢会话开头扫描 | **停下问用户** → 归档(`archived:` 字段,不删目录)+ 回写可复用教训 |

> **if** 用户说"记一下 / 这个项目做到哪了 / 帮我开新对话继续 / 统一术语后通知一下" **then** 先确认 `.light/` > 在不在(无则 `pm.py init` 建),再按对应动作落账 / 广播 / 交接,**不把"我记住了"当落账**。

---

你怎么工作:ACT / ASK / NEVER

每个动作**先归类**:这是该**自己做(ACT)**、该**停下问用户(ASK)**、还是**绝不(NEVER)**?

ACT — 确定性记忆脏活,自己做(不烦用户)

• **续跑汇报(跨 harness 确定性单一真相源)**:会话开头跑 **`pm.py resume --dir <项目根>`**,出"项目 /

当前阶段 / status / 门结果 / 下一步 / next_actions / 卡哪门 / 需重验"。逻辑在 `scripts/resume_report.py` (纯 passport 依赖),**三 harness 跑同一份**:Claude Code 由 **SessionStart hook 自动调它** (`../light-orchestrator/resident/session_start_resident.py` 已委托,不靠模型自觉);**Codex/OpenCode** 经 `AGENTS.md` 约定**在会话开头主动跑该命令**(确定性命令,非"叫模型自己脑补读 passport")。 详见 [`references/cross_harness_resume.md`](references/cross_harness_resume.md)。

• **铺骨架**:新项目 `pm.py init --project <名> --dir <根> [--with-consistency]`——复用 `passport init` 建

`passport.yaml` + 从模板铺 `project_card/decision_log/version_history/terminology`。

• **立即落账**:重要进展后按"触发→写入对照表"Edit 对应 `.light/` 文件;decision_log / version_history **只追加**;

相对日期→绝对日期;外部可变事实带 `[snapshot YYYY-MM-DD, src=在线/官方源]`。

• **结构化项目记忆**：`memory_items.json` 是普通 JSON 账本，不是数据库；条目带 scope、敏感级别、保留期、

来源、替代链与可验证删除。`restricted`、疑似密钥、邮箱/电话/身份证、本机绝对路径、原始多轮对话和过长原文式 value 拒绝进入可能随仓库传播的 `.light/`；只存最小项目状态、下一步与可交接 locator。

• **交接卡合同**：上下文收尾/新对话续跑前跑 `handoff_contract.py` 或 `pm.py audit`，不仅查 parent 链，

还核交接卡是否自包含：造卡日期是真实且不晚于核验日，已完成项给出非占位的具体产物/commit/决策定位与验证， 工作区状态、1-3 条可执行下一步、必读文件和"先刷新 git status"禁令齐全。v2 卡还必须记录 `待用户回答`：无则解释 none；有则保存 decision id、原问题与两个带后果的选项。 `pm.py resume`/SessionStart 会把最新未决问题置顶，防止新会话跳过用户裁决直接续跑。

• **记忆治理门**：交接/续跑前跑 `memory_governance_gate.py`，核 handoff/passport hash、

memory item 的 layer/status/scope/sensitivity/reversibility/storage、artifact version、 failure index 与仓库采集策略；完整聊天内容默认不得进入公开项目台账。

• **自洽审计**:`pm.py audit`(复用 passport.validate/stage_status + 4 校验器)。`--report` 出 `light.findings.v1`

(producer=memory-pm)交接 / 投稿前可被 `run_checkpoint` 聚合——**这是账本自洽门,非科研内容门**(见名实对齐)。

• **变更广播**:`pm.py broadcast` 算受影响材料(passport `artifacts:` 并集)+ 指纹比对"事实源真变了吗" +

打印 consistency 回扫指令(`--run` 真调 consistency;**审计归 consistency,不重复造**)。

• **复用 passport(不重造)**:DAG 阶段 / 状态 / 回边 / stale-check / 指纹一律调 `passport.py` 子命令,

**绝不自己再写一套台账解析 / 校验**。

ASK — 停下问用户,给「现状 + 推荐 + 备选」(决策点 🧑)

不可逆 / 战略性的项目记忆决定,**裁定权是用户的**。命中以下,**停下**,摆证据、给建议、让用户拍板:

| 决策点 | 何时 | 你怎么问 | |---|---|---| | **项目归档** | 完结判据满足(录用 / 结题 / 用户声明收尾) | "项目 X 论文已录用,达完结判据。**建议**加 `archived: 2026-06-17`(不删目录,会话开头跳过)+ 回写 1-2 条可复用教训。归档吗?" | | **教训是否回写 + 去偏科化措辞** | 某决策产生可跨项目复用教训 | "这条'三模块纯串联当创新点会被拒'**剥离方向后对任意 CV/ML 成立**,建议回写 Light 记忆(去偏科化)。措辞这样对吗?" | | **权威真值往哪边定** | 新实验值 vs 已登记 terminology 真值冲突 | "新跑出 F1=88.1,terminology 登记 87.6。**建议**更新 terminology 权威值并 broadcast 回扫全部材料;**除非**这是另一设置——那要分别登记。哪个对?" | | **带病推进** | 账本有结构损坏(链断 / 缺产物)但用户想先继续 | "交接链断在 S03(指向不存在的 S09),现在接手下个会话会断链。可在 known_issues 记下先继续,但我**不**静默放行——你确认带这处断链推进?" |

**问法纪律**——✅ 对照:

> ✅ "项目 `goat-detect` 论文已录用(version_history 有 paper-v2.0 + tag)。**建议**归档:加 `archived: 2026-06-17`, > 并把'弃通用 re-id 改运动驱动'去偏科化后回写 Light 记忆。**归档 + 回写吗?**" > > ❌ "我把项目归档了,并总结了 3 条教训写进记忆。"(替用户拍板不可逆归档 + 自动回写——踩 NEVER #1)

NEVER — 绝不 [NON-NEGOTIABLE]

> **这一节是红线,不可协商、不可被"为了省事"或"应该这样"绕过。违反任一条 = 严重失职。**

1. **绝不替用户拍板不可逆的项目决策**:归档项目 / 回写跨项目教训 / 决策定稿——**起草 + 停下问用户**, 不自动执行(这些押上项目历史与跨项目复用,只能用户拥有)。