多Agent虚拟开发：Skill 调用清单

一、Skill 调用总流程Skill 的调用遵循“触发-执行-反馈”的闭环模式由事件总线驱动。整个流程贯穿 L3 原子任务从发布到完成的各个阶段。图表二、项目目录树的生成机制这是MADS系统中所有 Skill 能够“知道代码写在哪里”的基础。2.1 触发时机时机触发者场景系统初始化系统启动脚本 / 初始化 Agent仓库第一次建立或每次启动 Agent 管理器时P1/P2 阶段开始前项目经理 Agent当一批新的 L3 任务被分发前用于刷新项目结构快照2.2 执行步骤图表2.3 项目结构快照的数据结构json{ root: src/mads/target_project/, packages: [ permission, crop, ui, utils ], files: [ src/mads/target_project/permission/permission_manager.py, src/mads/target_project/crop/crop_engine.py, src/mads/target_project/ui/main_activity.py ], class_map: { permission_manager: src/mads/target_project/permission/permission_manager.py, crop_engine: src/mads/target_project/crop/crop_engine.py } }三、增量开发P1阶段的 Skill 调用逻辑这是MADS系统能够支持P0 → P1 → P2 连续迭代的关键设计。3.1 核心原则基于已有成果进行“补充”而非“从头再来”当项目进入 P1 阶段例如开发“批量应用绿框位置”功能时系统不会删除或覆盖 P0 阶段已生成的代码。所有 Skill 的调用都基于以下逻辑场景行为目标文件不存在创建新文件写入代码目标文件已存在且需要增加新功能追加代码例如在crop_engine.py中增加一个新的方法目标文件已存在且需要修改已有功能修改现有方法例如完善crop_engine.py中的某个算法逻辑目标文件已存在但需要替换根据架构师约束或项目经理的明确指令决定是否覆盖3.2 具体示例P0 阶段已生成文件crop_engine.py中已有crop_image()方法实现基本的单图裁剪。文件路径src/mads/target_project/crop/crop_engine.pyP1 阶段新增需求新需求支持“批量应用同一绿框位置到多张照片”对应 L3 任务L3-03-01-03开发Agent调用CodeGenerationSkillSkill 的行为从共享上下文中读取项目结构快照。发现crop_engine.py已存在。决定在crop_engine.py中追加一个新的方法batch_apply_crop()而不是创建新文件或覆盖已有代码。生成代码并追加到文件末尾。触发CodeCompleted事件。3.3 增量开发在 Skill 调用中的体现python# skill_code_gen.py 中的增量处理逻辑 class CodeGenerationSkill: def execute(self, l3_task, context): project_struct context.get(project_structure, {}) target_file self._resolve_target_file(l3_task, project_struct) # 检查目标文件是否已存在 file_exists target_file in project_struct.get(files, []) if file_exists: # 增量模式读取现有文件追加新代码 existing_content self.mcp.read_file(target_file) new_code self._generate_incremental_code(l3_task, existing_content) self.mcp.write_file(target_file, existing_content new_code) mode incremental else: # 首次生成模式创建新文件 new_code self._generate_full_code(l3_task) self.mcp.write_file(target_file, new_code) mode new return { status: success, mode: mode, output: f代码已生成 ({mode}): {target_file}, artifacts: [{type: code, path: target_file}] }四、Skill 清单完整版以下是 MADS 系统中完整定义的 Skill 清单。每个 Skill 都对应一个具体的执行单元由特定 Agent 角色调用。所有 Skill 通过 MCP 工具与外部系统交互并遵循统一的输入输出规范。4.1 产品总监 (DoP) SkillSkill 名称功能描述输入输出调用的 MCP 工具requirement_bidding_coordinator启动多模型竞标向5个不同模型分发同一份用户原始需求。user_raw_text(str)candidate_schemes(list)无judge_model_call调用独立的裁判模型对5份匿名方案进行多维打分生成排名表。candidate_schemes(list)ranked_schemes(list)无requirement_fusion根据人类决策者的选择指令将1份或多份方案的优点融合生成最终的L0需求基准。ranked_schemes,human_decisionl0_requirement_documentwrite_file4.2 一级产品经理 (PM1) SkillSkill 名称功能描述输入输出调用的 MCP 工具l1_planning将L0需求基准按业务逻辑、技术依赖或用户旅程拆分为多个独立的L1里程碑。l0_requirement_documentl1_milestone_listwrite_filepriority_assignment为每个L1里程碑节点分配优先级P0/P1/P2。l1_milestone_listl1_milestone_list_with_priority无4.3 二级产品经理 (PM2) SkillSkill 名称功能描述输入输出调用的 MCP 工具user_story_splitting将每个L1里程碑拆解为多个L2用户故事/特性。l1_milestone_nodel2_user_story_listwrite_fileacceptance_criteria_generation为每个L2用户故事生成明确、可验证的验收标准。l2_user_story_listl2_user_story_with_ac无story_point_estimation使用 Fibonacci 数列估算每个L2用户故事的工作量。l2_user_story_with_acl2_user_story_with_points无4.4 架构师 (Architect) SkillSkill 名称功能描述输入输出调用的 MCP 工具constraint_extraction从L0需求基准文档的边界条件、风险点和非功能需求中提取初步的技术约束。l0_requirement_documentconstraint_draft_list无constraint_refinement细化初步约束为每条约束关联其适用的L2节点通过target_l2_ids并生成独立的架构师约束清单。constraint_draft_list,l2_user_story_listarchitect_constraint_listwrite_file4.5 项目经理 (PM) SkillSkill 名称功能描述输入输出调用的 MCP 工具l2_fusion读取L2用户故事和架构师约束清单将约束挂载到对应的L2节点上形成“融合后的完整L2节点”。l2_user_story_list,architect_constraint_listl2_node_completewrite_filel3_task_splitting将完整的L2节点拆解为3-10个L3原子任务每个任务预估时长≤4小时。l2_node_completel3_atomic_task_listwrite_filedependency_analysis分析L3任务列表明确各任务之间的前置/后置依赖关系。l3_atomic_task_listl3_atomic_task_with_deps无project_structure_discovery核心基础扫描目标项目的根目录生成当前项目的文件结构快照存入共享上下文。project_root_pathproject_structure_snapshotlist_files,read_file4.6 开发 Agent SkillSkill 名称功能描述输入输出调用的 MCP 工具code_generation根据L3原子任务、验收标准和架构师约束生成或追加代码到目标文件。支持增量开发追加/修改。l3_atomic_task,project_structure_snapshot,contextgenerated_code_pathread_file,write_file,make_dirunit_test_generation为生成的代码文件生成配套的单元测试脚本。code_file_pathtest_file_pathread_file,write_filegit_ops执行Git提交和推送操作将代码变更上传到远程代码仓库。commit_message,branch_namecommit_hashgit_commit,git_push4.7 测试 Agent SkillSkill 名称功能描述输入输出调用的 MCP 工具test_case_generation基于L2用户故事的验收标准生成具体的功能测试用例脚本。l2_user_story_with_actest_case_file_pathwrite_filedefect_reporting当测试失败时创建缺陷报告并自动分配给对应的开发Agent。test_failure_infodefect_idcreate_defectci_pipeline_trigger触发CI/CD流水线执行测试用例并收集测试报告。code_branch,test_case_pathpipeline_url,test_report_urltrigger_ci4.8 运维 Agent SkillSkill 名称功能描述输入输出调用的 MCP 工具environment_config根据应用信息生成环境配置文件如 Dockerfile、Kubernetes YAML 等。app_metadataconfig_file_pathwrite_filedeployment_trigger触发环境的部署动作将应用部署到指定环境。config_file_path,target_environmentdeployment_status_urltrigger_deployhealth_check对部署后的服务进行健康检查验证服务是否正常运行。service_endpointhealth_reportcall_http五、Skill 调用设计的核心原则原则说明职责单一每个 Skill 只做一件事如code_gen只生成代码不执行 Git 提交上下文驱动所有 Skill 共享同一个项目结构快照避免重复扫描增量优先当目标文件已存在时默认以“追加”或“修改”方式工作除非明确要求覆盖MCP 封装Skill 不直接操作文件系统通过 MCP 工具调用结果规范化所有 Skill 返回统一格式的 JSON方便下游 Agent 解析失败可恢复Skill 执行失败时返回明确错误信息触发Blocked事件六、总结项目目录树生成由ProjectStructureDiscoverySkill在系统初始化或 P1/P2 阶段前执行结果存入共享上下文。增量开发支持CodeGenerationSkill在生成代码时会检查目标文件是否存在。若存在则以“追加”或“修改”方式工作确保 P0 的成果不会被覆盖或丢失。P1/P2 阶段流程调用ProjectStructureDiscoverySkill刷新快照 → 生成新的 L2/L3 任务 → Skill 基于快照判断是“追加”还是“新建” → 执行 → 发布事件。该方案完整支持从 P0 到 P1 再到 P2 的连续迭代且所有 Skill 调用都是基于当前项目结构的上下文中进行的不会重复从头生成。