Personal Work OS:人机协作的日常研发工作流

40 阅读4分钟

受Claude Code Personal OS的启发搞了个个人工作流系统.

Personal Work OS 是一个本地优先的日常研发工作流。它把分散在 issue tracker、邮件、聊天、代码托管平台和本地仓库里的工作信号,整理成一条可审查、可交接、可回写的路径。 它不是一个完全无人值守的自动化系统,而是一个 human-in-the-loop 的个人工作操作系统:AI 负责收集证据、整理上下文、执行机械步骤和辅助编码;工程师保留判断权、确认权和最终责任。

它解决什么问题 日常研发工作经常不是从“写代码”开始,而是从“到处找今天该做什么”开始:

  • issue 是否有新分配或新评论
  • 聊天里是否有人明确 @ 你并指向任务
  • 邮件里是否有需要处理的事项
  • MR/PR 是否有评论、失败流水线或冲突
  • 本地分支是否需要同步基础分支
  • 昨天未完成的事情是否需要延续

如果没有固定入口,这些信息会变成每天早上的重复搜索成本。Personal Work OS 的目标是把它们压缩成一个稳定循环:

  • 收集当天信号,生成 daily cockpit
  • 按优先级选择任务
  • 生成 AI 可执行的 task packet
  • 在 repo、branch、scope 确认后再执行
  • 用只读 review 或 review-and-fix 检查 AI 改动
  • 提交 MR/PR 并回写状态
  • 下班前生成 closeout 和 carry-over

六个核心步骤

  1. Daily Start:生成当天驾驶舱 Daily Start 会把配置好的输入源汇总到一个本地 Markdown 文件里。输入源可以包括:
  • issue tracker
  • 邮件
  • 聊天 @me 消息
  • Git hosting 上的 MR/PR
  • 本地仓库同步状态

输出是一个当天的 run 文件,例如:workflows/runs/YYYY-MM-DD.md 这个文件通常包含真实任务、消息、链接和本地状态,所以默认应该被 git 忽略,不能直接发布。

  1. Pick Issue:生成 AI 任务交接包 当工程师选择一个任务后,工作流会生成 task packet。它通常包含:
  • issue summary
  • description 或 parent description
  • priority、due date、fixVersion 等元信息
  • AI 草拟的 acceptance criteria
  • 需要人工确认的问题
  • 建议的 repo、base branch、work branch 和改动范围

task packet 是“人类判断”和“AI 执行”之间的边界。AI 不应该在缺少 repo、branch、scope 等关键信息时直接开始改代码。

  1. Execute Task:AI 执行任务 执行前必须经过 human gate:
  • 目标仓库是否确认
  • base branch 是否确认
  • work branch 是否确认
  • 允许修改的范围是否清楚
  • 是否涉及共享代码、协议、生成文件或跨端行为

确认后,AI 可以读取代码、制定简短计划、做小步修改、补测试并跑本地验证。它不应该回滚无关本地改动,也不应该猜测不确定的产品边界。

  1. Review Result:两种 review 模式 Review 分成两种模式:
  • review read only:只读 review,只报告问题,不修改代码
  • review and fix:先 review,再修复明确的问题,补测试并重新验证

这个设计很重要。工程师有时只是想知道 AI 改得好不好,有时则希望 AI 继续把问题修掉。把模式说清楚,可以避免 AI 在不该动代码的时候动代码。

Review 重点包括:

  • 是否满足 acceptance criteria
  • 是否有行为回归
  • 是否改动范围过大
  • 是否有遗漏的边界状态
  • 测试是否覆盖关键路径
  • 是否误提交本地配置、日志、token、个人路径
  1. Submit MR / PR:提交团队评审 Submit 阶段负责把改动整理成团队可 review 的形式:
  • 只 stage 本任务相关文件
  • 展示 staged file list
  • 跑配置好的检查
  • 生成清晰 commit message
  • push 分支
  • 创建 MR/PR
  • 写好 What / Why / Validation / Risk / Issue 链接

Commit、push、MR/PR creation 都应该是 human gate。AI 可以自动完成机械动作,但需要工程师明确授权。

  1. Write Back And Closeout:回写和收尾 MR/PR 创建后,工作流会把结果回写到本地 artifact,必要时也可以回写到 issue tracker:
  • MR/PR 链接
  • branch
  • commit
  • issue 状态
  • preflight notes
  • remaining risk 或 follow-up

下班前再生成 closeout 草稿,帮助工程师确认:

  • 今天真正完成了什么
  • 明天第一件事是什么
  • 哪些 blocker 还在
  • 哪些流程摩擦值得继续自动化

为什么选择本地优先 这个工作流会处理很多敏感上下文,例如:

  • issue 原文
  • chat 消息
  • 邮件摘要
  • 内部链接
  • 本地仓库路径
  • 分支名
  • 账号、token、chat id
  • 真实 run/task 输出

所以它采用本地优先设计:真实输出只留在本机,并且默认被 .gitignore 忽略。

这个工作流的核心价值 Personal Work OS 的价值不是“让 AI 全自动替你工作”,而是把 AI 放进一个清楚、有边界、可追踪的日常流程里。

它让 AI 更像一个可靠的执行伙伴:

  • 先收集上下文
  • 再确认边界
  • 小步执行
  • 接受 review
  • 修复明确问题
  • 帮你整理提交和回写

而工程师仍然保留最重要的部分:判断、取舍、责任和最终确认。