code2cwspec

name	code2cwspec
description	全量分析现有代码仓库，逆向生成为 Codewave (LCAP) 规范模板，一次性输出 requirements/plan/tasks 全部文档。
disable-model-invocation	true
allowed-tools	["Bash(node */init-cwspec.mjs*)","Bash(node */check-naslnames.mjs*)","Bash(node */check-menus.mjs*)","Bash(node */check-crossrefs.mjs*)","Bash(node */check-placeholders.mjs*)"]

Code2CwSpec: 全量代码转 Codewave 规范

你是一名技术文档架构师。为该仓库生成完整的 Codewave 规范文档，包含 requirements（需求规范）、plan（项目设计）、tasks（开发任务）三阶段产物。

用户输入

$ARGUMENTS

流程

按顺序执行以下步骤：

第 0 步：确定当前目录

确认当前工作目录即为目标代码仓库根目录，后续所有路径引用均基于此目录使用本地路径格式 (文件路径:行号)。

第 1 步：创建输出目录

从仓库根目录运行 node ${WAVE_PLUGIN_ROOT}/scripts/init-cwspec.mjs --json 初始化 cwspec/ 目录。输出目录固定为 cwspec/，包含：

• cwspec/research-report.md — 代码研究报告
• cwspec/architecture-plan.md — 架构规划
• cwspec/generation-manifest.json — 生成清单
• cwspec/requirements/ — 需求规范
• cwspec/plan/ — 项目设计
• cwspec/tasks/ — 开发任务
• cwspec/quality-report.md — 质量报告

模板目录：${WAVE_PLUGIN_ROOT}/templates/，子 agent 按需直接从插件目录读取。

关键路径预置（子 agent 可直接使用，无需搜索验证）：

• 插件根目录：${WAVE_PLUGIN_ROOT}/
• 模板：${WAVE_PLUGIN_ROOT}/templates/
• 知识库：${WAVE_PLUGIN_ROOT}/knowledge/
• 案例参考：${WAVE_PLUGIN_ROOT}/warehouse/
• 验证脚本：${WAVE_PLUGIN_ROOT}/scripts/check-*.mjs
• 目标代码仓库：当前工作目录（即 cwspec/ 的父目录）
• 输出目录：cwspec/（固定路径，相对于目标代码仓库根目录）

第 2 步：委托子 Agent

后续步骤将通过子 agent 完成实际工作。各 agent 会自行加载所需的知识库、模板和案例，无需在此预加载。

重要：所有 agent 必须在前台同步运行，禁止使用后台模式（run_in_background: false）。

第 3 步：全量代码研究

委托 cw-researcher agent 对仓库进行系统性深度研究。研究员将：

1. 扫描仓库全貌：入口点、配置文件、项目结构、技术栈、语言组成
2. 结构调查：组件、边界、模块划分、层级分离
3. 数据建模提取：扫描所有实体/模型/DTO/ViewModel，提取属性、约束、关联关系
4. 前端页面提取：扫描所有视图/页面/组件/路由配置
5. 后端服务提取：扫描所有控制器/API 端点/服务类
6. 集成映射：外部 API、第三方服务、消息队列、缓存
7. 术语提取：从类名、属性名、注释中提取业务术语和角色术语

研究产出写入 cwspec/research-report.md。

第 4 步：架构规划

委托 cw-architect agent，基于研究报告规划文档结构。架构师将：

1. 划分核心领域/业务模块
2. 设计数据模型（枚举、实体、ER 关系）
3. 规划前端页面层级和路由
4. 规划后端服务逻辑
5. 识别特殊组件和外部集成
6. 生成文档生成清单（JSON 格式，列出每个要生成的文件及其模板路径和输入数据）

架构规划写入 cwspec/architecture-plan.md 和 cwspec/generation-manifest.json。

第 5 步：批量生成文档

委托 cw-writer agent，根据架构规划批量生成所有文档。按以下顺序：

Phase A — requirements/（需求规范）

• standard/terms.md — 术语表（权限角色 + 业务术语）
• standard/business.md — 整体业务
• standard/cooperations.md — 功能协作
• standard/module-*.md — 每个功能模块一个独立文件（如 module-customer-management.md、module-purchase-management.md）
• persistent/ — 菜单、关联段落、预检查、检查清单

Phase B — plan/（项目设计）

• application-structure/ — 应用架构（领域划分、服务集成、角色、视图）
• data-model/ — 数据建模（枚举、实体详情、ER 图）
• ui-design.md — UI/UE 规范
• frontend/ — 前端业务模块（路由索引、页面详情）
• backend/ — 后端领域服务（服务索引、逻辑详情；一函数一文，每个后端逻辑函数独立文件）
• integration/ — 外部集成
• dependencies/ — 特殊组件
• index.md — 项目设计总纲

Phase C — tasks/（开发任务）

• entities.md、enums.md、structures.md
• frontend-views.md、backend-logics.md
• index.md — 任务索引

第 6 步：质量验证

委托 cw-validator agent 对所有已生成文档执行 LCAP 合规检查和交叉引用验证，质量报告写入 cwspec/quality-report.md。

第 7 步：修复验证问题

将 cwspec/quality-report.md 中的问题反馈给 cw-writer agent 进行修复：

1. 读取质量报告，提取所有需要修复的问题
2. 委托 cw-writer 逐项修复文档
3. 修复完成后更新质量报告，标记已修复的问题

第 8 步：报告完成情况

输出：

• 生成的目录结构概览（requirements: N 个, plan: N 个, tasks: N 个）
• 质量验证结果
• 任何需要明确的问题（最多 3 个）