技能介绍

要解决什么问题

在 H5/Web 仓库里，Agent 常见失败模式是：还没对齐目标就改代码、把「改个文案」和「新页面从 0 到 1」走同一套流程，以及动到路由、状态、共享模块时缺少项目级约束。H5 Forge 把自身定位为项目内的 controller skill：对外只呈现具体模式（如功能开发、页面开发、轻量任务），对内用统一协议推进阶段，而不是让模型即兴发挥。

如何工作

命中 h5f- 触发词（须出现在消息行首）或用户明确要求结构化 H5 流程后，controller 按固定顺序：先路由 → 再分类 → 再展示模式 → 再执行。若任务不明确，链路停在路由环，写入 session 并追问，不进入实现。

路由侧会检测项目根状态（空目录 / 已有 H5 工程 / 非 H5），并按任务类型决定是否加载 project_guardrails。之后依次判定：直通（文档、环境、打包等）、新项目共创、UI 优化、架构级、页面开发、功能开发，或通过 10 秒测试 进入轻量路径。

Iron Law 与 Global Constitution 覆盖所有策略：h5f-fast 可在未升级的轻量路径上减少等待；h5f-a 可对缺口采用推荐方案推进，但不得自动补全目标、范围、验收与约束，且在安全、不可逆、生产、全项目架构切换等场景必须中断确认。实现阶段遇到 bug 须走 systematic debugging 四阶段；S2 方案确认完成后必须进入 S4，不得停在「结论」处等待。

重任务可走 S1→S2→(S3 拆包冻结)→S4→S5，S5 用 Rubric 量化评分并驱动有限轮迭代；大任务在宿主支持时可并行多工作包，S5 统一收口。角色通过隔离子代理与 Gate 5 写权限边界执行（需求/UI/架构分析师、页面工程师、验证工程师分工）。

适用边界

仅 empty_new 与 h5_existing（如存在 package.json + src/）允许介入；non_h5 直接退出。
消息中段出现的 h5f-、或仅因打开 H5 项目不会自动进入；需正式触发词或显式要求。
脚本路径相对于 skill 安装目录；失败时按 reference 降级，不因脚本缺失无限阻塞。
多工作包在已冻结前提下应连续执行至 S5，除非共享约束被破坏或命中高风险中断条件。

截图预览

使用场景

在已有 `package.json` 与 `src/` 的 H5 仓库里，消息行首用 `h5f-fast` 改指定页面的按钮文案，且不改路由与状态结构。
空项目根目录从零立项，走新项目共创 C0–C3，先冻结目录、路由方案与首批页面范围，再进入实现阶段。
用户提供 PRD 或需求说明起步，走功能开发 S1 确认 `quality_tier` 与 Rubric，再实现跨页面业务闭环并在 S5 评分迭代。
改动涉及状态管理、`src/shared` 或路由边界时，先补齐 `project_guardrails`，中等及以上任务输出改动契约后再写代码。

适合人员

维护 React/Vue 等 H5 单仓的前端工程师，局部改动可能碰到共享模块，需要路由分级与改动契约再动 `src/core` 或路由。
在空目录启动 H5 产品的全栈或前端负责人，要先对齐页面清单、信息架构与工程组织，再写首批页面而非直接堆代码。
需求目标已写在 PRD 里但缺组件与接口细节的开发者，希望用 `h5f-a` 按推荐方案推进，仅在生产或全仓架构风险处暂停确认。
负责新页面/新模块交付的页面工程师，需 S2 收口 UI 结构与路由接入，并在 polished/production 品质下接受 S5 Rubric 与 TDD 门禁验证。