用途:将 REFERENCE 实现中已可用的功能,按 TARGET 技术栈自身习惯迁移或重建。输入需明确三项:要迁移的功能、REFERENCE PROJECT-CODE(行为真相来源)、TARGET PROJECT-CODE(落地位置);三者未知前不开始发现,无法推断时以 Needs-user 说明缺失项,不猜测。
主要能力:把迁移信心落到磁盘,生成一份 gap map,含九个固定章节:参考行为/工作流、目标现状、缺失或错误、可复用目标代码与设计系统组件、所需测试、UI/设计差距与被迫的设计系统偏离、风险、首个切片、开放问题。每节不超过三条要点,均需证据引用(file:line、路由、迁移、测试),不粘贴证据。
使用方式:先读目标绑定上下文(GLOSSARY.md、AGENTS.md、UI 编码技能,按主题定位相关 ADR);再以定向检索追踪参考行为(工作流、导航、权限、状态、数据效果、字段校验与默认值、行与批量操作、导入导出、自动刷新、角色控制);然后调查目标现状与可复用组件;可选派发本地子代理并行处理互不重叠的发现。产物写入 <artifacts-root>/specs/port/<feature-slug>-gapmap.md,更新前先读旧文件并保留用户编辑与已记录决策。
限制:不实现任何产品代码、配置或迁移改动,唯一写入是 gap map;不自动串联,结束时仅建议 /grill-with-docs 并停止;输出不得含任何署名;不得硬编码技术栈规则,未记录的规则列入开放问题;不得批量读取仓库或 specs/ 树;mock、fixture 或桩数据不算行为真相,须标为推断。