light-memory-pm

npx skills add Light0305/Light-skills --skill light-memory-pm --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# 项目运行时记忆与项目管理（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` → 算受影响材料 →

python scripts/pm.py init --dir <项目根> --project "<项目名>" --with-consistency
python scripts/pm.py resume --dir <项目根>   # 一条命令出:项目/阶段/status/hash/门/下一步/卡门/需重验
Claude Code:SessionStart hook 自动调它(resident/session_start_resident.py 已委托,非重造);
v3 state_hash 会在报告中重算校验；内容被改而 hash 未更新时显式告警，不静默续跑。
python scripts/pm.py audit --dir <项目根> --today 2026-06-17        # 标准库报告
python scripts/pm.py audit --dir <项目根> --tags v1.0.0 v1.1.0      # 注入式 tag 核 version↔tag(离线/CI)
python scripts/pm.py audit --dir <项目根> --report .light/_audit/pm.findings.json   # 产 light.findings.v1
error 级(结构损坏/链断/坏日期/缺产物)→ verdict=fail(交接/投稿前应阻断);warn/minor → 卫生项不阻断。
python scripts/pm.py broadcast --dir <项目根>                       # 算受影响材料 + 打印 consistency 回扫指令
python scripts/pm.py broadcast --dir <项目根> --run                 # 真调 consistency 回扫(审计归 consistency)