核心用法
Senior Dev 是一套12步结构化生产开发流程,覆盖从任务启动到部署验证的完整生命周期。其核心设计目标是在长上下文对话中保持状态不丢失,通过文件化TODO追踪和标准化Git工作流实现可复现的工程实践。
执行流程
1. 环境初始化:进入项目目录,创建日期标记的TODO.md追踪子任务
2. 迭代开发:边执行边勾选TODO,同步维护CHANGELOG.md记录变更
3. 变更验证:git diff --staged强制审查,避免意外提交
4. 分支管理:使用Graphite CLI (gt) 创建命名规范分支,支持feature/、fix/、issue/、chore/四类前缀
5. 问题联动:Bug修复先建GitHub Issue,分支名嵌入编号实现自动关联
6. 堆叠PR:gt submit一键推送并创建/更新Pull Request,天然支持依赖PR的堆叠提交
7. 审查闭环:收到反馈后gt modify修改提交,保持提交历史整洁
8. 部署守护:合并后切换main分支,Vercel项目执行vl命令轮询部署状态,失败自动拉取日志并触发Issue创建
9. 完工报告:标准化输出格式包含项目名、PR链接、部署状态
显著优点
- 上下文持久化:TODO.md/CHANGELOG.md在上下文压缩后仍可恢复任务状态
- 工具链整合:Graphite的堆叠PR解决传统Git多分支混乱,GitHub CLI打通Issue-PR链路,Vercel CLI实现零配置部署监控
- 防错机制:强制diff审查、分支命名规范、部署失败自动日志收集降低人为失误
- 可审计性:CHANGELOG规范格式便于生成Release Notes
局限性与风险
- 工具强依赖:Graphite CLI学习曲线陡峭,团队成员需统一 adoption;
vl为自定义工具,非官方Vercel CLI功能 - 平台锁定:Issue/PR工作流深度绑定GitHub,Vercel部署监控对其他平台(Fly.io, AWS等)无原生支持
- 单点瓶颈:SMS通知环节在文档中仅提及概念,未给出具体实现,存在遗漏风险
- 规模化挑战:12步流程对小修复可能过重,TODO.md在多任务并行时需手动管理冲突
适合人群
- 中小团队Tech Lead或Senior Engineer,需规范团队Git工作流
- 全栈开发者使用Vercel托管,追求"代码提交即上线"的极致效率
- 长上下文AI协作场景(如Claude Code),需文件化状态抵抗会话中断
常规风险
| 风险点 | 缓解措施 |
|--------|----------|
| `gt`命令不熟悉导致分支混乱 | 团队统一培训,建立分支命名检查脚本 |
| TODO.md与真实进度脱节 | 强制要求每次对话开头读取并更新 |
| Vercel部署日志敏感信息泄露 | `vl`拉取日志后人工脱敏再创建Issue |
| SMS通知服务中断 | 建议降级为邮件/Slack webhook双通道 |