“给支付回调加上失败重试。”你把这句话丢给 Claude Code，它大概率立马定位到文件就开始改代码。可重试几次、怎么避免重复扣款、失败记录放哪、上线后怎么回退，这些问题全没个准数。真正的结对编程可不是两个人轮流敲键盘，而是先把判断对齐，再一段一段验证。claude-skills 的作用，也更像是给这段协作补上一套明明白白的交接规则。

开工前五分钟：先把猜测摊在桌面上

/common-ground 会先读取配置、代码惯例和已有上下文，再把 Claude 正在采用的假设一条条列出来。文档把它们分成三层：ESTABLISHED 可以当作已确认前提，WORKING 只是当前暂时默认的，OPEN 则应在继续之前先问清楚。比如“项目使用 PostgreSQL”可能已有配置佐证，“重试记录保留 30 天”却仍是待确认项。两者可不能抱着同样的信心写进实现。

这一步的价值是尽早纠偏，但要留意一个边界：Common Ground 自己也说明，它保存的是双方协调点，不是经过外部证明的绝对事实。涉及业务口径、合规要求或线上数据，仍要由人给出依据。

第一回合：只安排一个主技能带路

不必先点满 66 个技能。把任务写成“在 NestJS 支付服务中增加可配置重试，保持接口兼容，并补幂等与回归测试”，上下文路由才有足够信息选择主技能。新功能可以由 Feature Forge 收拢需求；架构复杂时再交给 Architecture Designer；进入编码阶段，才由 Fullstack Guardian 配合对应框架技能处理文件。每次交接都得带上已确认条件和仍未解决的问题。

第二回合：风险出现在哪里，就在哪里交棒

官方 Skills Guide 给出的新功能链路并非“一次生成到底”，而是从需求、架构、实现，继续走向测试、代码审查、安全、部署与监控。放到支付重试场景里，Test Master 要验证超时、重复回调和最大次数；Code Reviewer 检查改动范围；Security Reviewer 关注伪造回调与敏感日志。技能接力的意义，不是让回答变长，而是让不同风险各自有一次专门的停顿检查点。

第三回合：用证据结束，不用“应该能跑”结束

一轮实现结束后，让 Claude Code 给你报清楚修改了哪些文件、执行了哪些测试、失败项是什么、还有哪些假设没有验证。人再看差异、复现关键路径，并决定是否进入下一步。只要测试没跑、环境不具备，或者实际结果与计划对不上，就该保留未完成状态。结对程序员可以提出判断，却不能替你把猜测写成通过。

项目变大以后，再把回合拉成长流程

仓库的项目工作流把大型 Epic 分成发现、规划、执行和复盘四段。当前命令参考表列出八个生命周期命令，/common-ground 作为各阶段都能使用的辅助命令。它们会生成相互衔接的文档和工单，并在发布文档、创建 Jira 工单、偏离计划或关闭 Epic 前设置人工确认点。由于这些动作依赖 Jira、Confluence 与 Atlassian MCP，小型本地修复没必要硬套整条链路。

这些节点，人要主动拿回方向盘

• 数据库迁移可能丢数据，先确认好备份、兼容期和回滚方式。

• 权限、支付与隐私规则来源不明，先补上业务或安全依据再动手。

• 新增依赖会影响许可证、供应链或体积，先做人工选择。

• 准备部署到生产环境，先核对清楚监控、告警和审批责任。

可以直接复制的一段协作指令

先列出你对代码库、接口、数据和回滚的假设，标清楚哪些有文件依据、哪些需要我确认。等我回复后，给出最小改动计划；分阶段实施，每阶段报告变更文件、测试结果和剩余风险。涉及数据库、权限、新依赖或部署前，请停下来等我确认。

Claude Code 之所以能变得像结对程序员，不是因为技能数量突然变多，而是协作过程开始有了共同前提、明确的交棒、验证证据和人工停靠点。把这四件事守住，claude-skills 才会从提示词集合变成稳定的工作流；少了任何一件，它仍可能只是个写得很快的代码生成器。