04. 处理小变动(一般周期 - 小)

Guide阅读约 5 分钟

当 ywc-plan 将请求判断为 Small 时,它会自动进入此路径。判定标准是“是否可以作为单个 PR 完成而无需 Task 拆解?” 如果以下任何一项适用,它将被提升为 Medium/Large 而不是 Small(参见 05 )。

Back to table of contents

04. 处理小变动(一般周期 - 小)

何时使用此流程

ywc-plan 将请求判断为 Small 时,它会自动进入此路径。判定标准是“是否可以作为单个 PR 完成而无需 Task 拆解?” 如果以下任何一项适用,它将被提升为 Medium/Large 而不是 Small(参见 05)。

  • 包括数据库迁移
  • 介绍一个新的库/框架
  • 跨多个子系统

整体流程

guidebook
ywc-plan -> ywc-code-gen -> ywc-impl-review -> ywc-create-pr
步骤Skill角色
ywc-plan分析请求并创建 plan.md(什么 / 为什么 / 不在范围内 / 完成条件)
ywc-code-gen同时生成后端 + 前端 + 测试代码
ywc-impl-review在打开 PR 之前的最终代码审查
ywc-create-prPR 创建 -> CI -> 机器人审核检查

参考:Small 流程由 ywc-plan 直接产出 plan.md(并非 spec 文档),因此针对 spec 文档运行的 ywc-spec-ready 不属于此路径。ywc-spec-ready 是 Medium/Large 流程的 spec 收敛步骤(参见 05)。

注意ywc-code-gen 没有像 --review 那样的自动审查标志。如果跳过第 3 步(ywc-impl-review),PR 将在没有代码审查的情况下被打开,因此此流程必须显式运行它。中/大型流程的执行者可以使用 --review 标志自动执行此步骤——参见 05

示例运行

claude code
ywc-plan 登录失败的错误信息过于笼统,因此很难理解原因。希望显示账号锁定/输入错误/未注册等具体原因
claude code
ywc-code-gen --spec plan.md --feature "specific login failure reason"
claude code
ywc-impl-review
claude code
ywc-create-pr --title "fix: show specific login failure reason"

如果机器人审查意见、CI 失败或合并准备问题仍然存在,请继续使用 ywc-handle-pr-reviews <pr-number>。Small 流程基于 plan.md,因此没有 tasks/<task-name>/ 目录,并且它不适合 ywc-finish-branch 的任务完成处理。

当你在每一步都被阻挡时

情况动作
ywc-plan 将这项工作评为中等,而不是小型这是正常的 - 移动到 05. general cycle (medium/large)
ywc-code-gen 返回 BLOCKED规格可能不清楚或无法读取项目上下文 - 请检查报告的阻塞因素
ywc-impl-review 返回 DONE_WITH_CONCERNS如果是正确性问题,修复并重新运行;如果是观察结果,将其记录在PR描述中并继续
PR 失败 CIywc-create-prywc-handle-pr-reviews 会检查失败日志并尝试修复最多两次——如果仍然失败,该问题会显示为 DONE_WITH_CONCERNSBLOCKED

Previous: 03. Ship your first feature in 5 minutes - Next: 05. Handling work split into multiple Tasks