/openspec:apply 执行 migrate-static-data-to-nitro-query 任务
任务指令:执行 migrate-static-data-to-nitro-query 迁移工程
第一阶段:前置准备与规范内化
在启动任何修改前,你必须按顺序深度阅读并理解以下文档,并将其核心约束作为启动参数传递给所有子代理:
- 全局核心规范:
apps\admin\src\docs\prompts\各种杂项\2025-12-12-migrate-static-data-to-nitro-query\000-CORE-RULES.md - 类型安全规范:
.claude\agents\fix-type-error.md(严禁出现任何隐式 Any 或类型断言错误) - 验收检查清单:
apps\admin\src\docs\prompts\各种杂项\2025-12-12-migrate-static-data-to-nitro-query\001-CHECKLIST.md - 具体业务规格:
openspec\changes\migrate-static-data-to-nitro-query\specs目录下的所有文件。
第二阶段:动态任务编排与并行执行
1. 任务调度逻辑(主代理职责)
并发管理:主动开启多个后台运行的子代理并行工作。
任务拆分准则:
基准:初始建议每个子代理负责 3~5 个相关联的业务路径。
动态调整:若遇到文件超大或逻辑复杂路径,必须以“文件”为单位进行微粒度拆分,避免触发 400 错误或上下文超限。
状态同步(解决冲突):仅由主代理统一负责更新
openspec\changes\migrate-static-data-to-nitro-query\tasks.md。子代理完成任务后向主代理汇报,主代理核实后立即更新,确保进度文件不发生写入冲突。
2. 执行约束(严禁行为)
- 禁止脚本化:严禁编写 Python、TS、JS 或 Bash 脚本进行正则替换或批量删改。必须基于对代码逻辑的深度理解,手工完成语义化的改写。
- 连续运行:除非遇到无法解决的逻辑死锁,否则请持续运行直至全部任务完成,无需中途询问。
第三阶段:质量保障与多重审计
1. 深度复查机制
你需要专门开启一个审计子代理 (Audit Agent),对已完成的代码进行逐一“像素级”排查。审计要点包括:
- API 层:Hooks 是否正确创建?必填参数(Params)是否补全?
- UI 层:列表页是否严格遵循新的 Hooks 调用模式?Vue 文件中的下拉数组引用是否正确?
- 类型层:是否误删或误迁了非静态数据的 FormProps 类型?中文枚举类型是否已替换?
2. 幻觉抑制
- 重置机制:每当子代理完成一个阶段性批次,或者主代理感知到上下文滚动/合并时,必须重新读取一次
specs目录下的规范文件,强制刷新模型注意力。
第四阶段:思考模式 (Ultrathink Mode)
请全程开启深度推理模式,并在执行前按照以下逻辑进行思考:
- 深度推理:投入充足的 Token 进行推理,不要急于输出代码。
- 依赖分析:在指派子代理前,先分析业务路径之间的耦合关系,确保改写顺序合理。
- 动态编排:根据任务进度和子代理的反馈,实时调整后续任务的粒度。
- 回复语言:全程使用中文。