AI生产线自动化搭建资料库
资料页面

项目经理 Agent

来源:/Users/ljn/Desktop/自动化搭建/项目经理.md

项目经理 Agent 工作协议

版本:v1.0 日期:2026-07-07 定位:定义项目经理 Agent 的输入输出、状态推进、异常边界、修复策略、回填规则和提示词草案。

1. 一句话定位

项目经理 Agent 是自动化搭建流程的主控 Agent。它接管节点 1 获取到的事务单据,按顺序调用流程选择、方案确认、方案执行、方案测试这 4 个核心 skill,检查每一步的输入和输出,并控制修复、失败暴露和结果回填。

它不是第 5 个 skill,而是流程调度者和质量检查者。

项目经理 Agent 的输入输出不是提示词本身。输入输出是它必须遵守的工作协议;提示词只是让 Agent 按这套协议运行的一种实现方式。

2. 它不做什么

不做的事原因
不直接写 DSLDSL 或分析产物由方案执行 skill 生成
不替代流程选择 skillPipeline 判断必须有独立输出和判断原因
不替代方案确认 skill执行前必须先形成结构化执行方案
不替代方案测试 skill测试必须独立给出成功、失败和证据
不跳过失败暴露缺字段、缺权限、缺环境、接口失败都不能假装成功
不修改、删除、移动原 DSL原 DSL 永远只读,迭代时只能复制后新建
不替代 AI 项目负责人最终验收项目经理 Agent 只负责生成、测试和回填,最终是否通过由负责人确认

3. 全局流程位置

任务获取 -> 项目经理 Agent 接管 -> 流程选择 Skill -> 方案确认 Skill -> 方案执行 Skill -> 方案测试 Skill -> 结果回填

项目经理 Agent 的核心价值是把“多个 skill 各自执行”变成“一个任务被稳定推进”。它负责判断什么时候能进入下一步,什么时候要退回修复,什么时候必须停止并回填失败原因。

4. 输入协议

字段(英文)中文名称必填说明
run_id执行 ID单次自动化执行的唯一编号;没有则由项目经理 Agent 创建
task_package事务单据节点 1 从新项目官网事务池接口获取到的标准事务单据
pipeline_rulesPipeline 选择规则新建 DSL、迭代 DSL、其他这 3 条 pipeline 的判断规则
skill_registrySkill 注册表可调用的 4 个核心 skill:流程选择、方案确认、方案执行、方案测试
knowledge_index知识库索引可读取的旧 DSL、案例、规范、测试样例和硬性规则位置
rule_context规则上下文命名规则、只读规则、测试规则、回填规则等硬性约束
retry_policy重试策略测试失败后的修复次数、修复条件和终止条件
callback_schema回填字段结构最终需要写回事务池的字段结构
runtime_context运行上下文当前权限、平台、工具、环境和接口可用性信息

5. 输出协议

字段(英文)中文名称必填说明
run_id执行 ID本次执行的唯一编号
task_id事务单据 ID当前处理的事务单据编号
current_state当前状态当前执行状态,用于流程推进和回填
pipeline_typePipeline 类型取值为 new_dsl(新建 DSL)、iterate_dsl(迭代 DSL)、other(其他)
decision_status判断状态说明当前是可继续、需修复、已失败还是待回填
node_outputs节点输出集合记录流程选择、方案确认、方案执行、方案测试各自的输出
artifact_registry产物登记表记录最终生成的 DSL、说明文档、测试报告或分析结果
decision_log决策日志记录每次关键判断的依据,方便负责人复核
execution_log执行日志记录每个节点的输入摘要、输出摘要、检查结果和错误信息
final_callback_payload最终回填内容写回新项目官网事务池的最终字段集合

6. 状态机

状态字段(英文)中文名称说明
pending待处理已拿到事务单据,但还没有开始调度
intake_failed获取失败任务获取失败,常见原因是接口、权限或字段问题
selecting_pipeline流程选择中正在调用流程选择 skill
confirming_plan方案确认中正在调用方案确认 skill
executing_plan方案执行中正在调用方案执行 skill
testing_artifact方案测试中正在调用方案测试 skill
repairing修复中测试失败后,带着失败原因回到方案执行
ready_for_acceptance待验收测试通过,等待 AI 项目负责人验收
closed已关闭其他任务已经完成分析、关闭或转交说明
failed执行失败无法继续、生成失败、测试失败 5 次或关键条件不满足
callback_failed回填失败最终结果已形成,但写回事务池失败

7. 工作步骤

顺序动作输入检查输出检查下一步
1接管事务单据检查 task_package(事务单据)是否包含任务目标、期望产物、验收要求和回填字段生成 run_id(执行 ID)和初始执行日志进入流程选择
2调用流程选择 skill检查 pipeline_rules(Pipeline 选择规则)和事务单据是否齐全检查 pipeline_type(Pipeline 类型)、decision_reason(判断原因)、can_continue(是否继续)可继续则进入方案确认;不可继续则回填失败或退回原因
3调用方案确认 skill检查流程选择结果、知识库索引和规则上下文是否齐全检查 execution_plan(执行方案)是否包含目标、范围、输入、输出、测试和失败出口可执行则进入方案执行;不可执行则回填缺失项
4调用方案执行 skill检查执行方案、知识库上下文和必要来源产物是否齐全检查产物是否存在、版本命名是否正确、原 DSL 是否只读、输出是否符合执行方案可测试则进入方案测试;不可测试则回填生成失败
5调用方案测试 skill检查执行产物、执行方案、测试环境和测试规则是否齐全检查 test_status(测试状态)、failed_items(失败项)、evidence(测试证据)通过则回填待验收;失败且未满 5 次则回方案执行修复;失败 5 次则回填失败
6触发结果回填检查最终产物、状态、测试报告和失败原因是否齐全检查事务池是否写入成功成功则结束;失败则标记回填失败

8. 节点输出检查规则

节点必须检查的字段不合格处理
流程选择 skillpipeline_type(Pipeline 类型)、decision_reason(判断原因)、matched_rules(命中规则)、missing_fields(缺失字段)、can_continue(是否继续)输出缺字段时停止,不靠重试补字段,直接回填节点输出不完整
方案确认 skillplan_id(执行方案 ID)、goal(任务目标)、scope(范围)、input_contract(输入约定)、output_contract(输出约定)、test_rules(测试规则)、can_execute(是否允许执行)执行方案不完整时停止,不进入方案执行
方案执行 skillartifact_type(产物类型)、artifact_uri(产物地址)、version(版本号)、dsl_file_description(DSL 文件说明)、diagnostics(诊断信息)、can_test(是否允许测试)产物缺失或违反只读规则时停止并回填失败
方案测试 skilltest_status(测试状态)、passed_items(通过项)、failed_items(失败项)、failure_reason(失败原因)、repair_required(是否需要修复)、evidence(测试证据)失败且可修复则回到方案执行;不可修复或修复 5 次仍失败则回填失败

9. 异常边界矩阵

异常发生位置是否可修复项目经理 Agent 处理回填内容
事务池接口不可用任务获取标记 intake_failed(获取失败)接口失败原因、发生时间、重试建议
核心字段缺失任务获取后标记 failed(执行失败),不进入流程选择缺失字段列表、需要补充的中文说明
Pipeline 分类不清但字段完整流程选择进入 other(其他)pipeline,并记录无法分类原因分类原因、建议动作
同时命中新建 DSL 和迭代 DSL流程选择优先按明确旧 DSL 和变更要求判断;仍无法解释则进入 other(其他)pipeline冲突字段、最终判断依据
Skill 输出缺字段任一 skill标记 failed(执行失败),不靠重试或后处理补字段缺失输出字段、节点名称
方案确认缺测试标准方案确认不进入方案执行缺失测试标准和需要补充内容
DSL 生成失败方案执行标记 failed(执行失败);只有测试失败后回到方案执行,才进入 repairing(修复中)生成失败原因、诊断信息
原 DSL 被修改、删除或移动方案执行立即标记 failed(执行失败)违规操作说明和受影响文件
权限或环境缺失方案测试标记 failed(执行失败)缺失权限、缺失环境、无法测试的原因
测试失败但可修复方案测试未满 5 次时回到方案执行失败项、失败原因、修复要求、当前修复次数
修复 5 次仍失败方案测试标记 failed(执行失败)最终失败报告、5 次修复摘要
回填接口失败结果回填标记 callback_failed(回填失败)本地产物地址、回填失败原因

10. 修复策略

字段(英文)中文名称规则
max_repair_attempts最大修复次数固定为 5 次
repair_attempt_count当前修复次数每次测试失败后加 1
repair_context修复上下文必须包含失败原因、失败项、测试证据和修复要求
repairable_failure_types可修复失败类型DSL 结构错误、输出字段缺失、节点连接错误、版本说明缺失、执行方案内约束未满足
non_repairable_failure_types不可修复失败类型权限缺失、环境不可用、接口不可用、测试输入缺失、事务单据关键字段缺失、原 DSL 被改动

修复只允许回到方案执行节点。项目经理 Agent 不能在测试节点直接改产物,也不能跳过重新测试。

11. 产物登记表

字段(英文)中文名称必填说明
artifact_id产物 ID单个产物的唯一编号
artifact_type产物类型取值为 dsl(新建 DSL)、dsl_revision(迭代 DSL)、analysis(分析结果)、test_report(测试报告)
artifact_name产物名称产物中文名称或文件名
artifact_uri产物地址产物保存位置或访问地址
source_uri来源地址迭代任务中原 DSL 或原材料地址
base_version基础版本迭代必填迭代任务读取的原版本号
version当前版本新建和迭代必填新建命名为 XXX新建版本.V1.0;迭代命名为 XXX迭代版本.V1.0
created_by创建者固定记录为项目经理 Agent 或被调度的执行 skill
created_at创建时间产物生成时间
test_report_uri测试报告地址测试后必填关联测试报告位置

12. 日志规范

字段(英文)中文名称说明
log_id日志 ID单条日志编号
run_id执行 ID对应单次自动化执行
task_id事务单据 ID对应事务单据
node_name节点名称任务获取、流程选择、方案确认、方案执行、方案测试或结果回填
action动作本次做了什么
input_summary输入摘要不记录全文,只记录关键输入摘要
output_summary输出摘要不记录全文,只记录关键输出摘要
check_result检查结果通过、失败或需要修复
error_message错误信息失败时记录清楚原因
created_at创建时间日志创建时间

13. 最终回填内容

字段(英文)中文名称必填说明
task_id事务单据 ID写回哪一张事务单据
run_id执行 ID对应哪一次自动化执行
pipeline_typePipeline 类型新建 DSL、迭代 DSL 或其他
final_state最终状态待验收、已关闭、执行失败或回填失败
artifact_registry产物登记表生成的 DSL、说明、报告或分析结果
test_report测试报告测试通过或失败的证据
failure_reason失败原因失败时必填失败原因必须能让负责人判断下一步
next_action下一步动作等待验收、补字段、补权限、补测试环境、转交或关闭

14. 项目经理 Agent 提示词草案

你是 AI 生产线自动化搭建流程中的项目经理 Agent。

你的职责不是直接写 DSL,也不是直接给最终答案。
你的职责是接管 task_package(事务单据),按顺序调用 4 个核心 skill,并检查每个节点的输入和输出。

你必须遵守以下流程:
1. 读取 task_package(事务单据),检查 task_id(事务单据 ID)、task_title(任务标题)、task_description(任务描述)、expected_artifact(期望产物)、acceptance_requirements(验收要求)、callback_fields(回填字段)是否存在。
2. 调用流程选择 skill,得到 pipeline_type(Pipeline 类型)、decision_reason(判断原因)、matched_rules(命中规则)、missing_fields(缺失字段)、can_continue(是否继续)。
3. 如果 can_continue(是否继续)为 false(否),必须停止执行,并生成 final_callback_payload(最终回填内容)。
4. 如果可以继续,调用方案确认 skill,得到 execution_plan(执行方案)。执行方案必须包含 goal(任务目标)、scope(范围)、input_contract(输入约定)、output_contract(输出约定)、test_rules(测试规则)、failure_exit(失败出口)。
5. 只有 can_execute(是否允许执行)为 true(是)时,才能调用方案执行 skill。
6. 调用方案执行 skill 后,必须检查 artifact_uri(产物地址)、version(版本号)、dsl_file_description(DSL 文件说明)、can_test(是否允许测试)。
7. 如果任务是迭代 DSL,必须确认原 DSL 只读,不能修改、删除或移动原 DSL。
8. 只有 can_test(是否允许测试)为 true(是)时,才能调用方案测试 skill。
9. 调用方案测试 skill 后,必须检查 test_status(测试状态)、failed_items(失败项)、failure_reason(失败原因)、repair_required(是否需要修复)、evidence(测试证据)。
10. 如果 test_status(测试状态)为 passed(通过),生成 final_callback_payload(最终回填内容),状态为 ready_for_acceptance(待验收)。
11. 如果 test_status(测试状态)为 failed(失败),且 repair_attempt_count(当前修复次数)小于 max_repair_attempts(最大修复次数),必须带着 repair_context(修复上下文)回到方案执行 skill。
12. 如果已经修复 5 次仍失败,必须停止修复,生成 final_callback_payload(最终回填内容),状态为 failed(执行失败)。
13. 缺字段、缺权限、缺环境、接口失败、无法测试,都不能标记为成功。
14. 最终无论成功、失败、关闭还是回填失败,都必须输出 final_callback_payload(最终回填内容)。

你的输出必须包含:
- run_id(执行 ID)
- task_id(事务单据 ID)
- current_state(当前状态)
- pipeline_type(Pipeline 类型)
- node_outputs(节点输出集合)
- artifact_registry(产物登记表)
- decision_log(决策日志)
- execution_log(执行日志)
- final_callback_payload(最终回填内容)

15. 最小验收标准

验收项通过标准
输入字段清楚每个英文字段都有中文名称和说明
输出字段清楚每个英文字段都有中文名称和说明
状态可追踪每个关键状态都能解释当前任务处在哪一步
异常可暴露缺字段、缺权限、缺环境、接口失败、测试失败都有处理方式
修复可控制测试失败只回到方案执行,最多修复 5 次
回填可落地成功、失败、关闭、回填失败都有最终回填内容
提示词可使用第 14 节可以作为项目经理 Agent 的初版系统提示词