用途:为 Flutter 项目创建或适配 ACDD/MVVM 合约结构,覆盖 Android、iOS、macOS、Web、Windows、Linux,并生成、校验与审计页面、组件、路由、导航壳及 Figma 还原度。
主要能力:通过脚本执行多项任务,包括新建或适配项目、检查应用层配置缺失、生成页面与组件、提取共享 UI、执行 validate/validate_routes/validate_navigation_shell、审计 Figma 保真与数据、刷新、打包 BFF、生成 OpenAPI 转 Retrofit 代码。
必要用法:所有内置 Python 入口用 uv run --script <path> 运行;用 uv add --script <path> <dependency> 管理 PEP 723 依赖,禁止用 python、python3 或 uv run python 调用。新项目读 references/acdd_scaffold.md 并用 scripts/acdd_scaffold.py;适配既有项目运行 uv run --script <skill-root>/scripts/resolve.py --task adapt_project;检查应用信息用 --task check_app_info。合约任务通过 --task <gen_page|gen_component|extract_shared_ui|validate|validate_routes|validate_navigation_shell|audit_figma_fidelity|audit_figma_data|refresh|package_bff|generate_openapi> 解析后再按说明执行。
限制:不得对既有项目运行 acdd_scaffold.py --apply;审计不验证的开发者账号与证书被视为外部未核实,检查期间不得修改标识、签名、平台目标、图标或推送配置。布局按复用范围选择目录,模块须放在与基名匹配的叶子目录。共享 UI 提取须先 dry-run 并审核清单,批准后才可 --apply。Figma 相关工作须读取指定参考文件并按其审计命令前后执行。普通项目创建、适配、校验或修复期间不提出命令行打包或依赖下载优化;仅用户明确要求时才读相关参考并取得授权后应用。