Skip to content

Releases: Hugin-Z/solution-drafter

v1.0.0

12 Jun 02:41

Choose a tag to compare

中文政企(toG / toB)方案文档生成框架的首个公开版本。一个架构与工程实践的开源示范——仓库内的公司 / 产品 / 项目 / 客户均为虚构示例,不指向任何真实主体。

是什么

把零散输入(聊天 / 会议纪要 / 邮件)装配成规范的政府格式 docx(需求方案 / 解决方案建议书 / 实施方案 等)。形态是 Skill(纯文本契约)+ Python 工具链:任何能读 SKILL.md 工作流的 LLM agent 都可驱动,下层 Python 负责把 markdown 装配成字体合规的 docx。

架构:三层解耦 + 五阶段

  • 三层解耦:L1 框架层(scripts 工具链 + system + 5 阶段 stages / 与文档类型·领域无关)/ L2 文档类型层(outline.yaml + section prompts + template.docx)/ L3 领域插件层(可拔插 / run.py override 注入)。加新文档类型不动 L1、换领域不动 L2——并有内容哈希 baseline 测试锁定。
  • 五阶段工作流:S1 信息抽取 → S2 资料获取 → S3 模板填充 → S4 内容生成 → S5 评审修订。阶段间用 JSON / Markdown 文件传递(不靠 context 记忆),每阶段可独立重跑;用户在 S1(ack intake)与 S5(多轮评审)介入。

测试与 CI

  • pytest 18 项全过(outline 校验 / demo smoke / 字体安全 / 逐段落盘中断保活)。
  • GitHub Actions CI 绿。
  • 两个端到端 demo 可跑:examples/demo-需求方案/run.py(默认空领域)、examples/demo-槐序数据领域/run.py(接虚构领域插件);产物(draft.md / final.md / 字体合规 docx)落各自 output/

诚实边界(明确不保证什么)

  • 长文档:框架保证逐段落盘不丢已写(每章节 append + save),但不保证自动断点续写——续写依赖调用方是 agentic agent。
  • S2 资料获取:框架只定义 assets.json 契约 + 强制"拿不到写【待补充】不编造",不内置检索引擎、不提供真实素材库;真实素材由运行环境的 provider 接入(本地材料库 / RAG / ripgrep / SQL / 上传文档,手段无关)。
  • 数据:全部为虚构示例,不可直接用于真实项目。

License: MIT · Python 3.11+