Skip to content

日常工作流

RSP 根据用户意图、仓库权威信息、选定的 Change、当前证据、验证与阻塞项派生下一步操作。阶段是指导信息,不是持久状态。

选择当前工作

bash
rsp status
rsp focus <work-ref>
rsp show --focused

只有 .rsp/focus.d/ 中的标记文件会选择当前工作。存在多个聚焦的 Change 时,必须由用户或仓库上下文识别正在操作的目标。对于分组工作,先阅读同级 Group Brief,再阅读选定的子 Change。

修改前检查工作树,并保留无关的已修改、已暂存或未跟踪内容。聚焦与就绪不授予产品修改、Git、生命周期、发布或批准权限。

路由工作

text
结果或范围不清楚 → 塑造
实质性设计问题 → 设计
原因不明的失败 → 诊断
显式要求或具体风险需要测试先行 → TDD
证据充分的普通变更 → 实现
固定比较范围的请求 → 审查
已接受的发现 → 解决发现
显式确认的发布操作 → 发布文档

每项能力都返回同一 Change 或现有仓库归属位置。不要创建第二份计划、工作流状态或回执存储。

保持 Change 与现实同步

  • 实现推翻原计划时更新 Proposal、Spec 或 Design。
  • 仅在结果存在后勾选 Tasks。
  • 在 Verify 中记录最新运行的命令、覆盖范围、结果与相关遗漏。
  • 把尚未解决的外部或技术约束保留在 Blockers。
  • 优先选择成本最低的决定性验证。仅当新测试保护可观察行为或真实边界,并带来独立的长期信心时才保留。

仅用精确的依赖阻塞项指向另一个可执行 Change:

md
- requires `authentication/session-model`: 必须先落地会话归属关系

验证与审查

完成最后的相关修改后,运行与变更风险相称的检查。过去的运行结果已经过时。工具或环境缺失表示验证不可用;实际执行发现缺陷表示验证失败,二者都不能描述为通过。

审查使用固定的比较范围并保持只读。在明确的修改权限下修正已接受的发现,重跑受影响的检查,然后请求复审,不要自行宣称已经收敛。

持久化判断与归档

Tasks 与必需检查通过且无阻塞项后,分别判断是否需要:

  • 更新已有 Spec 或作用域指令,或创建新的持久化 Spec;
  • 为长期理由创建或更新 Decision Record。

然后显式归档:

bash
rsp ready <work-ref>
rsp archive <work-ref>

rsp ready 提供确定性的就绪信息与语义审查信号,仅供参考,并不代表归档已获批准。归档后重新检查完整的目标交付范围。提交、推送、发布、部署、批准与人工验收仍是独立权限。

恢复

如果后续证据表明原验收条件实际未满足,使用明确理由重开同一标识:

bash
rsp reopen <work-ref> --reason "<验收条件仍未满足的原因>"

多个归档匹配时,增加精确的 --from .rsp/archives/... 路径。Group 已关闭时先重开 Group。真正的新范围或独立交付的修正使用新 Change。