beats-pm-kit

Beats PM Kit（Beats 代理式 PM 框架）是 OfficeBeats 的一个项目，它封装了一个本地优先、跨运行时的框架，用于基于证据的产品管理工作流程。该框架将分散的产品上下文——会议、聊天线程、电子邮件、文档和笔记——作为纯 Markdown 本地存档，使其可搜索，并将其三角化为 AI 代理可以执行的工作流和任务。README 说明，该套件本身不会上传任何内容。 结构和概念 该套件使用编号的存储库分类法：0. 入库、1. 公司、2. 产品、3. 会议、4. 人员、5. 跟踪器、6. 资源、6. SOP、7. 合作伙伴、8. 客户，以及 .agent/ 用于规范代理、规则、技能、模板和工作流程，system/ 用于脚本、测试和文档。规范的任务状态位于 5. Trackers/tasks/ 中，以人类可读的 Markdown 笔记形式存在，具有稳定的 ID、证据链接、进度和决策；TASK_MASTER.md 和工作流笔记被描述为对这些文件的生成导航，而不是第二个真相来源。 单一真相来源 .agent/command-registry.json 拥有路由、别名、执行配置文件和运行时策略；.agent/workflows/ 拥有工作流程行为；.agent/skills/ 拥有可重复使用的 PM 方法。根适配器文件（AGENTS.md、CLAUDE.md、GEMINI.md、CODEX_COMMANDS.md）、.omp/config.yml 和工具忽略文件是生成的视图，由 system/scripts/sync_cli_adapters.py 产生——编辑 .agent/ 并重新生成是预期的路径，因为手动编辑的生成文件会被设计覆盖。 命令和上下文 每个斜杠命令通过注册表解析为一个工作流程文件和一个执行配置文件（快速、平衡或深入），并携带一个每运行时的推广级别：推广的命令作为原生技能发布，受保护的命令需要确认，其余的仅用于调度。记录的执行循环是路由、加载有界上下文、使用工具执行、检查点、验证、持久化工件；初始检索是受限的，原始证据仍然是本地哈希可寻址的，压缩的上下文可以追溯到源文件。 支持的运行时 入口点列出了 omp、Claude Code、OpenAI Codex CLI、Google Antigravity、Gemini CLI、GitHub Copilot，以及一个可选的 Obsidian UI，用于相同的存储库。README 说明，行为是根据积极检测到的能力选择的，而不是提供商层次结构，模型默认值继承自运行时，未知能力会失败。 入门和工作流程 设置是 git clone 加上 ./install.sh，这是一个围绕 python3 system/scripts/bootstrap.py --agent --non-interactive 的薄包装。Bootstrap 验证存储库、运行现有工作空间的升级兼容性门、创建被忽略的本地工作空间文件夹、播种模板、同步运行时适配器、尽可能安装 git 钩子，并运行隐私和适配器健康检查。然后，用户在运行时中打开文件夹，并运行 /start 或 /help。 工作流程分为以下几组：入库和证据（/paste、/find、/memory、/context、/chat 和消息集成）、会议（/meet、/transcript、/prep、/boss）、规划和战略（/plan、/create、/deck、/discover、/interview、/intel、/prioritize、/sprint、/retro）、跟踪（/track、/day、/week、/handoff）、通信和文档（/sop、/office-cli、/review、/challenge、/improve-plan）、质量和维护（/accuracy、/regression、/build、/vibe、/maintain、/update、/vacuum、/archive）以及设置/编排（/start、/help、/obsidian、/pack、/team、/fan-out）。自然语言输入也得到支持。 本地实用程序 可重复的工作被委托给 system/scripts/ 中的仅 stdlib Python 脚本，包括用于对任务、标签和引用进行有界只读查询的 vault_query.py；用于跨本地证据文件夹进行索引全文检索的 context_router.py；用于规范任务笔记写入和快速入库的 task_store.py 和 task_intake_fast.py；用于准备、验证和处理会议记录的 transcript_pipeline.py；用于在执行前对混乱的 PM 输入进行分类的 pm_decision_router.py；用于将该套件文件夹用作 Obsidian 存储库的 obsidian_bridge.py；用于启用休眠可选功能（例如 Trello）的 pack_manager.py；用于预检和可逆迁移旧配置的 upgrade_compat.py；以及用于阻止私人内容泄露和生成适配器漂移的 privacy_guard.py / adapter_guard.py。 隐私和测试 隐私姿态是本地优先：个人存储库文件夹被 gitignore，并且仅通过骨架 .gitkeep 文件进行跟踪，本地运行时状态位于被忽略的 .beats/ 中。守卫脚本（privacy_guard.py --tree、adapter_guard.py --mode check）阻止私人内容、个人路径、类似令牌的字符串、记录和适配器漂移进入共享提交。WATCHDOG.md 定义了顾问规则，例如不伪造引用、ID 或日期，对出站发送进行明确的用户批准，以及将任务状态保存在规范跟踪器中。README 添加了以下警告：该套件本身从不将文件同步到云服务，但所选的 AI 运行时会在该提供商自己的设置下处理提示和工具输出。测试位于 system/tests/ 中，采用 pytest 风格，并涵盖注册表、适配器、任务存储、记录管道、隐私和适配器守卫、升级兼容性以及存储库不变性。 致谢 Beats PM Kit 是基于日常产品工作构建的；行动优先的输出策略被描述为一种独立表述的方法，受到 MIT 许可的 i-have-adhd 项目的启发，但没有捆绑任何上游插件或钩子代码。