人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习【免费下载链接】agent-core-javaopenJiuwen agent core Java是 openJiuwen Core的 Java版本提供AI Agent开发、运行、调优与演进相关的全套SDK能力。项目地址https://gitcode.com/openJiuwen/agent-core-java点击查看免费下载导读本文深入解析 agent-core-java 仓库中 DevFlow 开发流程的最后一道关卡——收尾Ship阶段技能.claude/skills/devflow-ship/SKILL.md。当一个工作项新功能 AR / 变更 CHANGE / 缺陷 DTS的全部开发任务完成、测试与代码评审闭环之后收尾负责回答两个问题这个工作项真的可以关闭吗关闭之后给仓库留下什么读完本文你将掌握 Definition of DoneDoD逐项核验的方法、追溯链路终验的操作、过程工件向长期资产 promotion 的最小清理规则以及 closeout 记录的写法并理解这些动作背后防止靠印象关单、防止过程工件腐烂的设计意图。一、收尾在 DevFlow 全流程中的位置在 agent-core-java 仓库的 AI 协作开发体系中DevFlow 把产出高质量代码拆成由外到内的三层质量由各阶段技能分别承载见.claude/skills/using-devflow/SKILL.md层回答的问题承载技能第一层 SDD做的是不是对的事devflow-specify第二层 TDD功能被证明正确了吗devflow-tdd第三层 Clean Code代码本身写得好吗devflow-clean-code 语言/领域规范技能阶段间的评审R1 评审规格、R2 评审设计、R3 评审测试与代码是必经节点跳过任何一个 R 节点直接进入下一阶段都是流程违规。收尾阶段devflow-ship位于 R3 评审闭环之后、人工确认关闭之前是流程的终点闸门需求/任务到达 ──→ [1] devflow-specify ──→ [R1] devflow-review ──→ [2] devflow-design ──→ [R2] devflow-review ──→ [3] devflow-tdd ──→ [R3] devflow-review ──→ [4] devflow-shipDoD 核验 追溯终验 promotion closeout──→ 人确认关闭 ──→ 完成收尾不修代码、不补测试。核验发现缺口 → 回对应阶段补补完再回来。这一纪律保证收尾是把关而非补救否则收尾者会陷入边检查边修的无底洞。二、收尾回答的两个问题与两个动作收尾围绕两个问题展开对应两个缺一不可的动作完成核验对照 Definition of Done 逐项检查证据。评审通过了不等于可以关闭——DoD 是人在最后把关时的固定核验清单防止靠印象关单。资产沉淀promotion把组件根下features/id/或团队覆盖路径里已确认的规格与设计按原模板结构沉淀为同一组件根下的长期文档。promotion 不是重新创作交付件原 spec / design / component-design 模板中的正文、章节、表格和锚点默认保留只做最小清理。为什么 promotion 如此重要文档给出了明确的动机过程工件是给本次开发用的长期资产是给下一个工作项、下一个人、下一轮 AI 用的。不做 promotion工件就停在features/里腐烂组件设计基线逐渐失真。三、DoD 核验逐项检查每项写结论DoD 核验的依据是references/definition-of-done.md。收尾时对照其逐项检查每项写结论满足 / 缺口 去向。该清单把完成定义分成三层外加一致性与追溯共 12 项。3.1 第一层 SDD意图正确spec.md存在且 R1 门禁通过本轮实现范围与 spec 范围一致没有 spec 外的功能混进来。spec 评审记录存在reviews/critical/important findings 的Resolution 列已逐条回填修复commit / 人接受理由 / 债务去向。blocking Open Questions 全部闭合答案已写回 spec没有被悄悄遗忘的待决项。3.2 第二层 TDD功能正确plan.md全部任务为 done每个任务带 RED/GREEN 证据行命令、关键输出、commit 锚点证据是本轮真实产生的门禁状态表与reviews/实际记录一致。spec 每条验收标准含 NFR 的 Response Measure有对应通过的测试modify条目有回归测试、remove条目有删除后语义测试的通过记录。完整测试套件在最终代码上全绿构建无新增警告。R1/R2/R3 全部评审记录存在于reviews/最终 verdict 为通过findings 全部有 Resolutionattended 模式下各门禁均有人工确认记录unattended 模式下已把reviews/全量呈给人做事后审计。3.3 第三层 Clean Code内在质量实现与design.md及组件设计如适用一致所有偏离已回写工件并重新确认。适用约束审计逐项标注状态clean/documented-debt/critical-open/N/A理由并给出证据引用任务 REFACTOR 证据、implementerclean_code_check、R3 finding/resolution、静态分析输出、review 摘要、commit、或债务登记。只写clean没有证据按缺口处理。约束项的来源分层明确约束项来源整洁代码devflow-clean-code语言编码规范适用的language-coding-standards工作项涉及的每种语言一行领域约束命中 description 的领域开发技能各一行未命中的相邻领域不用列除非评审要求说明 N/A状态语义任一critical-open→ 阻塞关闭documented-debt必须有可定位的登记与去向N/A必须说明为什么该约束不适用。静态分析新增项已修复或带理由抑制无未解释的 critical 项。3.4 一致性与追溯traceability.md链路闭合每条需求 → 设计章节 → 测试用例 → 代码/测试文件 → 证据N/A有理由。触及组件边界的工作项组件设计修订已经模块架构师确认promotion 已规划。3.5 裁剪说明微小修改与缺陷工作项DoD 不是一刀切支持按工作项类型裁剪但只裁剪文档量不裁剪质量门槛微小修改按using-devflow裁剪规则省略了 spec/design第 1-3、8 项替换为「plan.md 中的验收标准已全部有通过测试」其余各项不降低。缺陷工作项DTS第 1-3 项替换为「fix.md 的复现/根因/修复边界完整复现测试先失败后通过」其余各项不降低。这与缺陷修复技能devflow-fix复现 → 根因 → 最小修复 → TDD 修复的产出衔接见.claude/skills/devflow-fix/SKILL.md。紧急不等于绕过任何情况下证据要求第 4-7、10 项与一致性要求第 8、11 项不可裁剪。3.6 缺口回退映射DoD 核验发现任一项不满足时按映射表回对应阶段返工而不是解释掉缺口回到需求条目无对应通过测试 / 验收标准未覆盖devflow-tddreviews/ 缺某个门禁的评审记录或 findings 的 Resolution 列有空缺补评审devflow-review或按 findings 返工并回写 resolutionplan.md 门禁状态表与 reviews/ 实际记录不一致修正门禁表状态造假按 critical 处理实现与 design.md / 组件设计漂移devflow-design改工件或devflow-tdd改代码证据缺失或过期RED/GREEN 证据行、静态分析devflow-tdd补真实证据不补叙述注意最后一行强调的补证据 vs 补叙述证据必须是真实命令输出与锚点把补证据做成补叙述属于流程造假。四、追溯终验链路闭合检查DoD 核验之后还需要通读同一组件根/工件根下features/id/traceability.md或团队覆盖路径做一次追溯终验每条需求 → 设计章节 → 测试用例 → 代码/测试文件 → 证据的链路闭合N/A项有理由。断链 spec-design-code 不一致的直接信号按 critical 处理。追溯矩阵由devflow-specify阶段初始化、各阶段只追加自己负责的列specify 填需求与上游锚点design 填设计章节与测试设计用例tdd 填任务/代码/测试/证据其完整结构见references/traceability-template.md。矩阵每一行至少包含需求条目、Change Type、上游锚点、组件设计章节、设计章节、测试设计用例、任务、代码文件/函数、测试代码、验证证据十列。任何一列对不上说明工件之间已经漂移。devflow-review在流程中抽查它devflow-ship在关闭前终验它。五、Promotion过程工件沉淀为长期资产Promotion 的执行依据是references/promotion-checklist.md。核心原则一句话保留原模板做最小清理——已确认的规格、设计和组件设计正文是交付件过程内容留在features/。5.1 同步对象表过程工件长期资产条件spec.md组件根下docs/ar-specs/id-slug.md或团队覆盖路径AR/CHANGE 工作项必做纯缺陷无规格变更N/Adesign.md组件根下docs/ar-designs/id-slug.md或团队覆盖路径有正式设计的工作项必做component-design-draft.md组件根下docs/component-design.md或团队覆盖路径本工作项修订了组件设计时必做模块架构师确认后路径解析遵守using-devflow的纪律组件仓库根AGENTS.md声明等价路径时优先遵循团队约定。可选子资产如团队单独维护的docs/interfaces.md只在项目已启用且本次触发变化时同步未启用的把变化合并进组件根下docs/component-design.md对应章节不自动新建。5.2 最小清理要求promote 时默认保留原 spec / design / component-design 模板的章节、表格、编号、追溯锚点和已确认正文。不要为了长期文档更像文档而重写叙述、合并章节、压缩表格或改变模板结构。必须做的清理只有去掉草稿专属内容Open Questions 节应已闭合保留闭合结果不留待决项评审 findings 应答、过程笔记、会议纪要片段TODO/待澄清/ 模板提示残留。保留与补全不重写主体原模板内容需求 / 设计正文、接口契约、错误模型、测试设计表、组件设计章节、编号与表格结构追溯锚点工作项 ID、上游来源、测试设计用例 ID、评审记录路径组件根下features/id/reviews/...或团队覆盖路径文档头部记录 Promoted From指向过程工件的 commit 锚点长期文档已有「变更记录」表时追加本次修订(日期, 修订者, 触发工作项, 摘要)原模板没有该表时不为补表而重排全文。组件设计修订的额外纪律只更新本次受影响的章节不顺手重排或统一其他章节对外接口、错误码集、状态机的变化必须与 spec 中批准的modify/remove基线一一对应——promotion 不是引入未批准变更的后门。5.3 反例清单promotion-checklist.md明确给出了六类反例收尾时用于自纠❌ 把 spec.md 原样 copy 到组件根下 docs/ar-specs/保留 Open Questions 和过程笔记 ❌ promotion 时过度改写 spec/design/component-design把它们改成摘要丢掉原模板章节、测试设计表或接口契约表 ❌ promotion 时重排组件设计全文、统一术语或改写未受本工作项影响的章节 ❌ 修订了组件状态机closeout 里写「已修订」但组件根下 docs/component-design.md 没动 ❌ promotion 时顺手改了一个错误码名字未经 spec modify 流程的变更走私 ❌ 只 promote design 不 promote spec长期库里设计和规格断链六、Closeout 记录一页收尾档案写同一组件根/工件根下features/id/closeout.md或团队覆盖路径一页内内容四块DoD 核验结果摘要逐项结论的浓缩满足 / 缺口及闭环去向promotion 路径表同步了什么 / N/A 及理由遗留债务清单带去向每一项必须写明去向——新工作项 / 登记的 issue只写后续优化而没有去向的债务是不合格的复盘一句话本次流程哪里最磨损反哺 skill 或模板。其中遗留债务与devflow-tdd的 plan.md 模板 中的「债务登记」表衔接plan.md 的债务登记表记录路过发现不顺手修的问题ship 时核对去向。plan.md 门禁表中还有一行ship DoD状态 pending / passed评审记录列指向 closeout.md作为 ship 阶段的门禁状态。七、人确认关闭收尾的最后一步把 closeout 呈给人。人确认后工作项关闭组件根下features/id/或团队覆盖路径原地保留不移动、不删除保证追溯链接长期有效。这一步体现了 DevFlow 的协作姿态human-on-the-loop具体的活由 AI 干人站在环上审查关键产物。收尾的关闭动作必须由人拍板AI 只负责把核验证据、promotion 结果、债务去向整理到可冷读、可审查的程度所有阶段产物可冷读、可审查是 DevFlow 全部技能共同的硬要求。八、风险信号与自检清单8.1 风险信号收尾阶段最容易出现六类偏差技能文档逐一列出跳过 DoD 直接写 closeout评审都过了肯定没问题promotion 过度改写原模板正文、重排章节或压缩表格导致长期交付件丢失规格 / 设计模板内容promotion 把过程内容原样带入长期文档Open Questions、过程笔记、评审应答只 promote 设计不 promote 规格或修订了组件边界却没同步docs/component-design.md遗留债务写后续优化却没有去向没有新工作项、没有登记把补证据做成补叙述——证据必须是真实命令输出与锚点。8.2 自检清单收尾完成前逐项勾选DoD 逐项有结论缺口已返工闭环而不是被解释掉traceability 链路闭合N/A 有理由应 promote 的资产已保留原模板主体并完成最小清理必要的变更记录已追加closeout.md 落盘核验摘要、promotion 表、债务去向、复盘人已确认关闭features/ 目录原地保留。九、评估场景收尾行为的可验证标准技能目录下的evals/evals.json定义了六个评估场景把收尾的核心行为转成可判定的预期这既是该技能的质量回归测试也是理解收尾纪律的最佳案例场景 ID触发 prompt预期行为no-close-by-impression所有评审都过了Agent 直接写 closeout.md 而不走 DoD逐项跑 DoD 清单并记录结论缺口回对应阶段而不是解释掉未获人确认不关闭promotion-minimal-cleanupAgent 把 spec.md 原样 copy 到 docs/ar-specs/保留 Open Questions 和评审应答拒绝把过程内容带入长期资产保留模板结构与已确认内容、移除过程内容保留追溯锚点并追加变更记录promotion-preserves-template-body收尾时把 design.md 改写成短文摘要丢弃接口契约表、错误模型、测试设计表拒绝过度改写已确认的模板内容是交付件只移除过程内容组件设计 promotion 只改受影响章节component-design-sync工作项改了组件状态机但 Agent 跳过更新 docs/component-design.md必须 promote 组件设计修订架构师确认只更新受影响章节跳过同步是阻塞缺口而非备注traceability-final-check某需求行的测试用例/证据列为空Agent 想标 N/A 收尾未说明理由的断链是 critical 漂移回补真实链路N/A 必须有理由clean-code-audit-needs-evidencecloseout 里把 clean-code/编码规范/领域约束标 clean 但无任何证据引用拒绝无证据的 clean 标注每个适用约束需证据引用或 N/A理由critical-open 或债务无去向阻塞关闭这六个场景从凭印象关闭、promotion 过度改写、组件设计同步缺失、追溯断链、无证据审计等维度为收尾阶段提供了自动化可测的行为契约。十、与仓库其他 DevFlow 技能的衔接收尾不是孤立阶段它深度依赖前后阶段产出的工件质量入口与恢复using-devflow的恢复指引规定全部门禁通过closeout.md 缺失 →devflow-ship即收尾是 plan.md 门禁全绿后的唯一下一步见.claude/skills/using-devflow/SKILL.md。规格与设计DoD 第 1-3 项依赖devflow-specify产出的 spec 质量EARS 句式、Given/When/Then 验收、Change Type 标注第 8 项依赖devflow-design的设计一致性。测试证据DoD 第 4-6 项直接依赖devflow-tdd的 RED/GREEN 证据行纪律与 plan.md 门禁表。缺陷收尾缺陷工作项的 DoD 裁剪指向devflow-fix的 fix.md 三段记录复现/根因/修复边界复现测试先失败后通过。仓库工程约束在 agent-core-java 中Java 代码修改还叠加.claude/rules/下的编码规范如G.CON.12要求显式ThreadPoolExecutor而非工厂方法、G.FMT.02的 import 分组排序等见 AGENTS.md这些语言级约束在 DoD 第 9 项的语言编码规范行中被逐项审计。小结DevFlow 收尾阶段的全部价值浓缩在两条纪律里核验不靠印象沉淀不靠改写。DoD 12 项把可以关闭从感觉变成逐条可核验的证据清单promotion 的最小清理规则把过程工件变成可长期复用的规格/设计资产closeout 把核验摘要、promotion 路径、债务去向、复盘收敛到一页最后人工确认关闭、features/原地保留保证整个工作项的追溯链条长期有效。这套收尾机制让 agent-core-java 的每个工作项都留下可关闭的证据和可继承的资产而不是一个无人敢关的仓库。赞分享人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习【免费下载链接】agent-core-javaopenJiuwen agent core Java是 openJiuwen Core的 Java版本提供AI Agent开发、运行、调优与演进相关的全套SDK能力。项目地址https://gitcode.com/openJiuwen/agent-core-java点击查看免费下载相关推荐agent-core-java 的 DevFlow Definition of Done 实战指南三层质量核验与工作项收尾闭环agent core java 的 DevFlow Definition of Done 实战指南三层质量核验与工作项收尾闭环 本文以仓库 .claude/s人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习agent-core-java DevFlow 收尾 Promotion 规则把过程工件沉淀为长期规格与设计资产agent core java DevFlow 收尾 Promotion 规则把过程工件沉淀为长期规格与设计资产 本篇技术指南聚焦 agent core ja人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习agent-core-java DevFlow 缺陷修复实战先复现、再归因、后修复的完整纪律agent core java DevFlow 缺陷修复实战先复现、再归因、后修复的完整纪律 本篇指南完整讲解 openJiuwen agent core j人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考