用途:比对需求设计文档与最终实现代码,逐项识别差异并驱动对齐,直到设计文档与实现一致。可独立调用,也可作为 subagent 由 arkweb-architect 调度。
输入:requirement.md 与 design.md 为必需(路径形如 {docs_dir}{feature-name}/{date}-{feature}-requirement.md 与 -design.md);spec.md、analysis.md 为可选;实现代码目录({WORK_HOME}/)必需。未提供时自动查找 {DOCS_REPO}/docs/features/{feature-name}/ 下文档。
主要能力:收集设计文档、规格、分析报告与代码三方信息,从接口/API 签名、数据结构与枚举、类与继承、方法列表、参数返回值、流程状态机、错误码、Feature Flag、多语言绑定范围、模块划分等维度逐项比对并列出差异。逐个差异用 AskUserQuestion 展示设计描述、实际实现与差异分析,请用户决策:A 接受实现(就地回写设计文档原始章节)、B 要求重做(交由 coder+reviewer 循环,最多 3 轮)、C 暂时搁置(记为遗留事项)。随后按决策执行,并重新比对检查是否引入新差异,循环上限 5 轮,最后输出差异统计与处理总结。用 TodoWrite 追踪六个步骤进度。
适用场景:OpenHarmony/ArkWeb 等功能开发中,设计与落地代码出现偏离,需要在人工确认下完成设计与代码的对齐闭环。
限制:每个差异必须由用户逐项决策;回写仅改不一致段落,不改文档整体结构;重做检视存在 BLOCKER/CRITICAL 时继续修复循环;达到 5 轮仍未对齐则停止并建议人工介入;设计文档不存在或代码中未找到实现时会报错或列出未实现项,建议先完成实现。启动时需声明“我正在使用 arkweb-design-alignment skill 进行实现设计对齐。”