用途
fmway-dev 是一个指导产品功能开发的流程型技能,强调「不猜测、按阶段推进、在每个关键门控获得用户批准」。它适用于需要明确发现、PRD、带门控的实现规划或批准的新功能开发工作。
主要能力
该技能定义了从 Phase 0 到 Phase 5 的完整开发流程:
- Phase 0 发现与调研:阅读 PRD.md、docs/ 与 docs/prds/ 下的文档,检查 docs/requirements/{slug}/TICKET.md(若存在),澄清产品请求、代码上下文、影响模块与假设,输出退出标准;若关键未知未解决,先提问再进入 PRD。
- 隔离配置:询问用户选择在当前 checkout 创建新分支(
git switch develop && git pull --ff-only && git switch -c feat/{slug})或创建独立 worktree(git fetch origin develop && mkdir -p .worktrees && git worktree add .worktrees/{slug} -b feat/{slug} origin/develop)。存在未提交更改时先暂停询问。 - 状态跟踪:按 ways/v1alpha1 契约维护
.ways/state.json,记录 flow、way、branch、phase、isolationType、文档与 gates 等。 - Phase 1 PRD 撰写:在
docs/prds/{prd-slug}/PRD.md生成包含状态、问题、目标、非目标、用户故事、功能需求、非功能需求、数据模型变更、UI/UX 说明、开放问题、冲突与依赖的 PRD。 - Phase 2 实现计划:在
docs/prds/{prd-slug}/PLAN.md生成阶段、任务、测试计划与回滚说明。 - Phase 3 实现:在选定分支或 worktree 中实现,遵守项目 CLAUDE.md 约定,按逻辑检查点运行验证命令,并建议调用 fmway-pr 提交。
- Phase 4 验证:执行功能需求、测试、类型检查、lint、构建、回归、依赖审计与安全审查清单;安全审查包括依赖审计(npm audit --omit=dev、pnpm audit、pip-audit 等)与新代码人工审查,敏感变更建议调用 fmway-security。
- Phase 5 PR 集成:按 feat/{slug} → develop → main 顺序通过 PR 集成,建议调用 fmway-pr 推送与创建 PR,不直接合并分支。
使用方式
该技能以流程规则形式工作,用户触发后按阶段推进;每个门控(PRD、计划、测试、PR 到 develop、PR 到 main)均需用户明确批准后才继续。文件与命令严格按资料中定义执行,不自行创建分支或 worktree 除非用户选择。
适用场景
适用于需要正式 PRD、分阶段规划、测试验证与 PR 流程的产品功能开发,尤其适合团队协作中需要可追溯文档、状态记录与门控审批的场景。
限制
资料中未提供具体工具实现、运行环境、收费模式或平台信息;流程中提及的 fmway-pr、fmway-po、fmway-security 等技能的可用性未说明。状态文件 schema 引用外部规则,未在本技能内定义。安全审查依赖项目已有工具,命令因技术栈而异,未提供通用默认命令。