面向军工/软件研制场景,以 Coding Agent 自然语言驱动,实现「文档 + 原型 + 源码 + exe」齐套性自动化交付
摘要:面向军工/软件研制场景的「文档 + 原型 + 源码 + exe」齐套性自动化交付工作站。由 1 个编排包(doc-delivery-orchestrator)+ 4 个可独立使用的 SKILL 包组成"专家团",以 Coding Agent(Kimi Code / Claude Code / codex 等)自然语言驱动,将需求素材直接加工为齐套交付物:配套 docx 文档、交互原型、原型图 PNG、源码骨架、Windows exe。
一、背景与痛点
软件研制项目的交付,往往不是"写完代码"就结束,而是要一次性交出一整套齐套产物:需求文档、设计文档、交互原型、原型图、源码、可运行的安装包。传统模式下,这些产物由不同角色分别产出,版本与口径经常对不齐:文档描述的和原型演示的不一致,原型里有的功能和最终 exe 里对不上,返工与对齐成本居高不下。
软件齐套性交付工作平台,将需求输入后的工作升级为一条完整流水线:需求拆分 → 信息确认 → 对齐锁定 → 原型/文档/源码/打包并行生成 → 统一验证交付,并以工作站方式进行编排,目标是让"需求素材"直接变成"齐套交付物"。
二、整体架构:调度核心、编排层与能力单元
整体上是一套"1 + 4"的专家团结构:
- 调度核心:自然语言驱动的 Coding Agent(Kimi Code / Claude Code / codex 等),承担与用户对话、理解需求、按 SKILL 规范执行任务
- 编排层:doc-delivery-orchestrator(主理人),负责收需求 → 项目输入清单(含模块/CSCI 划分)→ 解析模板 → 生成对齐表 → 统一齐套性验证与交付说明汇总
能力单元为四个自含 SKILL 包,各自内嵌可独立运行的技术栈:
| SKILL 包 | 技术栈 | 能力 |
|---|---|---|
| 文档处理 | Python + python-docx | 处理 docx |
| 原型出图 | 版式库 HTML + 无头 Edge 截图 | 出原型图 PNG |
| 打包 | Electron 离线优先 + electron-packager | 生成 Windows exe |
| 质量兜底 | 对齐确认 + 相位闸门 + 读回验证 | 三道质量机制(详见第五节) |
三、核心工作流与相位闸门
完整编排流程如下:
主理人(doc-delivery-orchestrator):收需求 → 项目输入清单(含模块/CSCI 划分) │ [早并行] 源码骨架(零文档依赖) ▼ 解析模板 → 对齐表(含原型清单) ▼ 用户确认①(对齐表) ├─► [原型车道] 交互原型 app/ → 用户过目② → 截图出 PNG ├─► [文档车道] N 份文档并行:映射填充 + 插图 + 样式验证(PNG 就绪后放行) └─► [打包车道] electron-packager 打包 Windows exe(app/ 确认后并行) ▼ 主理人:统一齐套性验证 + 交付说明汇总 → 交付关键要点:
- 源码骨架在需求收集阶段即启动,零文档依赖
- 全程只收口两处用户确认:对齐表确认(①)、原型稿过目(②)
- 文档车道等待原型图 PNG 就绪、打包车道等待 app/ 确认后才放行,构成相位闸门
四、三条并行车道详解
- 原型车道:需求确认后先生成交互原型 app/,用户过目后截图出原型图 PNG。原型是文档插图与打包的前置输入。
- 文档车道:N 份文档并行,按模板映射填充 + 插图 + 样式验证;等待原型图 PNG 就绪后放行,避免文档插图与原型不一致。
- 打包车道:基于已确认的 app/ 目录,用 electron-packager 打包 Windows exe,与文档车道并行推进。
五、质量保障机制
- 对齐确认:模板解析后生成对齐表(含原型清单),用户确认后才进入并行派发,避免方向性返工
- 相位闸门:下游车道等待上游关键产物(PNG / app/)就绪后才放行,控制依赖时序
- 读回验证:主理人对全部产物做统一齐套性验证,汇总交付说明后再交付
六、子项目工作区规范
SourceCode下按子项目建工作区(历史演练wrj、yw、wrjty等;工作区也可按任务指定在仓库外,如D:\temp3),结构约定不变:
| 目录 | 用途 |
|---|---|
dist | 原型交互打包的 exe |
output | 输出的文档 |
prototypes | 基于需求拆解的原型设计(交互原型 app/、源码骨架 src/、原型图 PNG) |
reference | 用户输入的需求、参考文档 |
templates | 参考模板文档转 docx 的中间目录(本身是 docx 则无需转换) |
work | 工作流工作中间资源(py、json、md、ps1 等) |
七、快速上手
在 codex / claude code / kimi code 等 Coding Agent 中提问,或用 workbuddy 的专家团形式提问,示例:
D:\xxx目录下的pr.txt是我输入的需求,其它的doc/docx是提供的另外项目的参考模板, 你结合完成完整的软件齐套性输出。AI 会先搜集必要的外部信息(需方、开发方、起始日期、密级等),需要人工回答;如果不想在搜集执行中被询问过多,可以在提问需求时同时带上这些已知内容。
详细情况可关注微信公众号私信细聊,微信公众号:玄宿科技
八、小结
这套工作台的核心价值有三点:
- 全链路自动化:从需求素材到文档/原型/源码/exe 齐套交付的全链路自动化,非技术用户也可驱动
- 模块化能力:4 个 SKILL 包可独立使用,便于按需组合与演进
- 质量可控:两处人工确认 + 相位闸门 + 读回验证,把"对齐"成本降到最低
适用于军工/软件研制等需要按模板齐套交付的场景,是"结合 Coding Agent 的工作站架构"在软件交付领域的一次落地实践。