用途:为交付新功能提供结构化、门禁驱动的工作流,从需求发现与受理开始,依次经过 PRD、实施计划、编码、验证和 PR,每个关键门禁都需用户明确批准。
主要能力:先做仓库资格检查(读取 ~/.ways/config.yaml 黑名单,命中则询问是否例外或停止);Phase 0 发现与受理,读取 PRD.md、docs/ 与 docs/prds/ 文档,必要时先读 docs/requirements/{slug}/TICKET.md,梳理需求、代码上下文与受影响模块;随后询问隔离方式(当前检出分支或独立 worktree),分支用 git switch -c feat/{slug},worktree 用 git worktree add .worktrees/{slug} -b feat/{slug} origin/develop;用 .ways/state.json 跟踪阶段与门禁(prd、plan、testing、pr-develop、pr-main)。
使用方式:Phase 1 产出 docs/prds/{slug}/PRD.md 并停在 Gate 1;Phase 2 产出 PLAN.md 并停在 Gate 2;Phase 3 按 CLAUDE.md 约定实现,检查点运行 pnpm typecheck && pnpm lint && pnpm test;Phase 4 验证并运行 Snyk 代码/依赖扫描与 bash run-sonar.sh,写 TESTING.md 后停在 Gate 3;Phase 5 经 PR 合并 feat→develop→main。提交与推送建议调用 incu-way-prepare-pr,本技能不自行 git add/commit/push。
限制:需用户在每个门禁确认;PRD 编号用锁机制避免同机冲突,但无法解决跨机器未拉取的竞态;安全扫描工具不可用时须记录并询问用户,不得谎报通过。