Senior Dev

核心用法

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双通道 |

核心用法

senior-dev 是一套面向生产环境的完整开发工作流 Skill，通过 12 个标准化步骤将「任务启动→代码实现→PR 提交→部署验证→完成报告」全流程串联。核心依赖 Graphite CLI（gt）实现栈式 PR 管理，GitHub CLI（gh）处理 Issue 追踪，Vercel CLI（vl）做部署监控，并强制维护 TODO.md、CHANGELOG.md 等上下文文件以抵抗对话压缩。

典型流程：进入项目目录 → 创建/更新 TODO.md 拆解任务 → 编码并勾选完成项 → git diff --staged 自检 → gt create 建分支并提交 → gt submit 推 PR → 代码审查循环（gt modify 改 PR）→ 合并后 vl 监控部署 → 输出标准化完成报告。

显著优点

1. 上下文韧性：TODO.md/CHANGELOG.md/PLAN.md 三文件体系确保任务状态跨对话 session 不丢失，适合长周期开发。
2. 工具链整合：Graphite 的栈式 PR 天然适配 AI 辅助的增量提交场景，避免「一个巨大 PR」的审查噩梦；Vercel 的自动日志抓取降低部署故障排查成本。
3. 分支语义化：feature/、fix/、issue/、chore/ 前缀规范使仓库历史自解释，便于后续 AI 或人类追溯。
4. Issue-PR 联动：强制在 fix 类分支先建 GitHub Issue 再关联 PR，形成可审计的缺陷跟踪闭环。

潜在局限

• 工具锁定：重度依赖 Graphite（商业服务，个人免费但团队付费）、GitHub、Vercel 三件套，使用 GitLab/Bitbucket/自托管 CI 的团队需大量改写命令。
• CLI 前置成本：用户需预装 gt、gh、vl 并完成认证，首次配置门槛不低。
• SMS 通知空头承诺：文档提及「SMS notifications」但全文无任何短信配置或调用逻辑，仅为占位描述。
• 无语言/框架感知：工作流通用到需要开发者自行填充具体技术细节（如测试命令、lint 步骤），并非「开箱即用」的脚手架。

适合人群

• 使用 GitHub + Vercel 技术栈的中小型团队开发者
• 需要向 AI 精确描述「当前做到哪一步」的复杂任务场景
• 希望规范个人 Side Project 工作流程的独立开发者

常规风险

• 分支命名冲突：若团队已存在不同分支规范，AI 严格执行本 Skill 可能导致命名混乱。
• CHANGELOG 维护疲劳：手动维护 Unreleased 区块在频繁迭代中易成为形式主义。
• Graphite 服务依赖：一旦 Graphite 服务或定价策略变化，整个工作流需重构。