用途:按一个真实用户任务贯穿系统,产出可持久、受权限约束的结果。适用于真实功能、接手的客户项目,或需要真正持久化与访问控制的原型路径。
主要能力:先定位契约,检查需求说明、仓库指令、既有 UI/数据模式、API、schema、测试与环境,明确参与者、入口、动作、结果与工作边界;除非必要且获授权,保留原有产品模型、技术栈、路由与集成。区分已验证能力与未知依赖,常规细节从工作区解决,仅在缺失决策会实质改变结果时才提问。
实现分层:用真实产品词汇与既有原语构建界面,保留层级、可访问性与响应式;定义输入输出与错误契约,运行时校验不可信数据,只暴露浏览器所需字段;在服务端强制认证、授权与组织/资源范围,不把提交的组织 ID 当作成员资格证据;实现持久化与完整性约束,并发编辑定义冲突行为,重复或中断写入使用幂等/对账机制;确认结果后更新正确缓存或视图,区分已接受的后台任务与最终完成;覆盖加载、空、拒绝、无权与未知结果状态,按敏感度与生命周期保留草稿;明确迁移与部署兼容性,应用回滚不会撤销已存数据或外部影响。
验证:使用隔离的测试身份与数据,重放关键路径,刷新验证持久化,检查未授权直接请求,演练最高后果的恢复路径;为有意义的不变量添加聚焦测试,不靠镜像实现的断言凑覆盖率。检查失败时修复原因并重跑,直到全部通过或能指出阻塞点。运行适用的仓库检查,查看窄/宽渲染结果,确认失败可在不记录密钥或原始敏感载荷的情况下诊断。
交付:说明可工作的变更、证据、契约/迁移说明,以及仍未验证的运维依赖;不要把 mock 标为已完成的真实集成。服务不可用时,完成安全的本地边界并说明阻塞端到端验证的具体原因。
限制:不用于无持久化或强制约束的选项探索(用 $prototype);不用于仅补缺失状态(用 $states);不用于纯视觉打磨(用 $craft);不用于判断结果是否支持演示、试点或生产(用 $readiness);不得仅为演示完成而发布、合并、通知客户或更改账户权限。