PM Manager — local project governance skill pack

PM Manager — local project governance skill pack

为什么重要

对用户的 Hermes / llm-wiki 实践，它的重要性在于把 agentic coding 的外层管理从聊天记忆迁移到 repo-local、可审计、可仪表化的 .pm/ 工作台。很多 coding agent 失败不是因为不会改代码，而是因为不知道今天最该做什么、哪些问题是阻塞级、哪些只是噪音、release 前应先看什么证据。PM Manager 把这些问题显式变成 board、todo、incident、health scan、dashboard 与 slash commands。

机制 / 一阶原理

PM Manager 的机制可以概括为“本地项目控制面”：

1. State layer：在应用仓库内创建 .pm/，保存 overview、todos、incidents、module findings、dashboard 等治理状态。README 明确 .pm/ 是 developer-side governance workbench，通常 git-excluded。
2. Command layer：提供 /pm-init、/pm-status、/pm-next、/pm-done、/pm-fix、/pm-all、/pm-arch 等命令，把日常项目管理动作变成 agent 可执行入口。
3. Adapter layer：支持 Cursor、Claude Code，以及可读 SKILL.md 的其他 skill hosts；CLI 可安装/刷新不同 agent adapter。
4. Evidence/UI layer：/pm-all 做 gated full governance scan，输出 noise-filtered blocking/high 摘要，并生成 .pm/dashboard/index.html 与 architecture diagrams。

一阶原理是：agent 工作需要一个外部化的项目状态和优先级函数。没有这个层时，agent 会倾向于直接写代码、响应最近粘贴的信息、或被低价值问题牵引。把 “what to fix next” 写成 stateful workflow，可以降低上下文漂移、重复 triage 和 release 前漏检。

与既有 wiki 概念的关系

• 对 Loop-Engineering：PM Manager 是一个小型外层 loop 的 state/workbench：每天 /pm-status 给 Top3，/pm-next claim，/pm-done close，再通过 dashboard 反馈项目健康。
• 对 Harness-Engineering：它把完成门禁、incident triage、release scan 和 dashboard 作为 coding-agent harness 的治理层，而不是只靠模型临场判断。
• 对 Spec-driven-development：Spec Kit 偏 “what to build”；PM Manager 偏 “what needs attention now”。二者组合时，spec 是需求/设计合同，.pm/ 是运行期项目治理合同。
• 对 External-Agent-Skills-Design-Patterns：它展示了 skill pack 不只是单个 SKILL.md，而是 CLI + templates + commands + adapters + dashboard 的多层封装。

对 Hermes / llm-wiki 的可执行启发

1. 为 llm-wiki radar 建一个轻量 .radar/ 或 run-receipts/ 状态区：存储候选池、未入库原因、访问失败、今日 Top3 follow-up，而不是只写自然语言 log。
2. 把“每日 Top3”迁移到知识维护：每次 radar 不必深挖很多材料；可维护一个候选优先级队列，按 novelty/depth/actionability 选择最多 2-4 个。
3. 把 incident triage 用在 wiki 自动任务：例如 arXiv 429、GitHub rate limit、vector reindex 失败、broken wikilink 应进入 health/todo，而不是每天报告后遗忘。
4. 本地优先、云 PM 非必需：llm-wiki 当前已是 markdown vault，用 repo-local governance 比接 Jira/Linear 更轻量，也符合用户一个 vault 的偏好。
5. 可视化 dashboard 可作为后续高风险改动：短期先写 markdown receipt；长期再考虑 HTML dashboard 或 Dataview 页面。

失败模式 / 边界条件

• Alpha 与生态新：GitHub API 显示仓库 2026-07-21 创建，stars 38，仍是 alpha；不应直接把它安装进用户生产 profile。
• .pm/ 默认 git-excluded 的权衡：本地私有状态适合个人/敏感数据，但跨机器、跨 agent、可审计历史可能受限；需要明确哪些状态应版本化、哪些应本地私有。
• 可能与现有 TODO/ConversationSpec 重叠：Hermes 已有会话级 ConversationSpec 思维，PM Manager 的 .pm/ 不能替代它；更适合代码仓库级项目治理。
• 治理噪音：扫描和 dashboard 如果缺少 severity gate，会制造更多“看起来要处理”的低价值事项。

深度判断

值得 deep ingest，因为它提供了可复用 workflow：把 coding agent 的项目管理外层做成本地、可审计、命令化、可视化的治理工作台。它能直接启发 llm-wiki 的无人 radar：维护候选池、每日 Top3、incident/失败状态和 release/health scan，而不是每天从零发现、从零判断。

写入记录

• 2026-07-23 09:00 CST：新增 source 页，基于 README 提炼 PM Manager 的 .pm/ 本地项目治理、每日 Top3、incident triage、release scan 对 Hermes/llm-wiki loop 状态管理的启发。