用途:这是 humane 方法中的实现适配技能,负责把已经足够确定的设计决策翻译成现有设计系统实际提供的组件、模式、令牌、主题、模板与检查机制。它不决定产品应该是什么,Humane 方法(job → evidence → concept → prototype → review → learning)始终高于任何预设。若系统无法表达已接受的方案,预设只能报告,不得悄悄改动任务、验收标准、内容层级、交互模型或原型。
主要能力与用法:先建立实现简报,记录不可变输入(任务或结果引用、证据引用、已接受方案与验收标准、被适配的原型、未决事项与评审发现),引用即可,缺失时标注 Humane 可追溯性不可用。然后选择并验证预设:用户显式指定优先,否则只读检查 package.json、锁文件、框架配置、组件目录、令牌文件、Storybook 配置、MCP 配置与本地已安装二进制。预设名只是引导提示而非证据,须探测原生接口并记录实际暴露能力,探测结果与预设参考冲突时以探测为准。事实来源优先级依次为:项目本地机器清单或文档化编程 API、已安装 CLI 的类型化 JSON、受 schema 治理的注册表或生成的项目清单、协商后的 MCP 工具与资源、已安装包类型与项目文档、远程文档(仅作带引用的兜底)。仅探测不得下载 CLI、启动服务器、连接远程注册表或安装 MCP 服务器,这些属于独立网络或安装操作,需用户批准。
实施流程:先发现再组合,为目标范围建立小型目录,保留来源信息。在打补丁前先产出适配计划,映射到原生资源,列出所选组件、模式、模板、主题与令牌、每项选择如何服务验收标准、拟执行命令与文件操作及确切目标、冲突与偏差、之后运行的原生检查、未验证或不受支持的部分;规划阶段只读,若无原生预览或 diff 则视为无法安全应用。仅在预览获批后应用,首次写入前须展示预览并询问,批准只覆盖所示操作;框架自有变更必须使用框架支持的 CLI 或公共 API,不得复刻安装器、注册表解析器、codemod 或主题编译器。依赖安装、网络获取、--force/覆盖、eject/swizzle、codemod 或迁移、主题替换、代理指令编辑、锁文件变更、生成文件写入与删除等操作永不隐式执行。
验证与限制:分两条线验证,框架线只运行所发现系统实际提供的检查(schema 校验、doctor/集成检查、类型生成与类型检查、构建、story 交互测试、无障碍检查、令牌/引用检查或项目测试)并记录命令与证据;Humane 线回溯到实现简报,确认任务、概念、层级、交互与原型行为未漂移。状态用 pass、fail、warn、not-run 或 not-supported,未运行与不受支持不算通过。不得覆盖 Humane 语料、证据、概念、原型笔记、评审发现、学习产物、已接受的产品意图、信息层级、交互模型或文案、项目令牌、主题、框架配置、代理指令、锁文件、源码自有或被修改的组件、生成文件、密钥凭据、未知注册表元数据或 DTCG 扩展,也不得为迁就预设而改动无障碍要求。框架与实现简报冲突时,停在适配计划并指明需由用户决定的事项,适配器没有裁决权。输出只读发现时返回预设、观察到能力、已检查资源、局限与下一步安全操作;实施时返回适配计划、获批操作回执,以及拆分后的验证结果,并声明向 humane:review 交接但不自动执行。