在工地上写施工技术方案是家常便饭,但这活儿的痛点是:格式要求死板(分章节、编号步骤、每道工序展开写),返工率高(甲方/专家动不动打回来改格式),重复性大。 我的解法:用 WorkBuddy 生成 python-docx 脚本,把文档排版抽象成一组辅助函数,让 AI 只负责"写内容、调函数",格式 100% 可控。方案如下,可直接复现。
一、核心思路:先定函数,再让 AI 写内容 排版是工程文档的硬约束,不能交给 AI 自由发挥。我把常用版式封装成 9 个辅助函数:
from docx import Document from docx.shared import Pt, RGBColor, Cm doc = Document() defh1(t): return doc.add_heading(t, level=1) # 一级标题defh2(t): return doc.add_heading(t, level=2) # 二级标题defh3(t): return doc.add_heading(t, level=3) # 三级标题defpp(t): return doc.add_paragraph(t) # 正文段落defblt(t): return doc.add_paragraph(t, style='List Bullet') # 项目符号defnum(t): return doc.add_paragraph(t, style='List Number') # 编号步骤(工序必用)defmt(title, body): # 注意事项块 p = doc.add_paragraph() p.add_run('【注意事项】' + title).bold = True p.add_run(':' + body) deftip(t): # 风险提示(红色) p = doc.add_paragraph() r = p.add_run('⚠ ' + t) r.font.color.rgb = RGBColor(0xC0, 0x00, 0x00) r.bold = Truedefpage_break(): return doc.add_page_break() # 分页
二、给 AI 的提示词模板(直接可用)
你是施工方案编写助手。请基于以下现场条件,生成一段可运行的 python 代码,
代码调用上述辅助函数(h1/h2/h3/pp/blt/num/mt/tip/page_break)生成完整文档。
规则:
1. 每道工序必须用 num() 展开为编号操作步骤,写明参数、顺序、验收要点;
2. 禁止出现"按规范施工"这类无信息量表述,只写具体可执行的措施;
3. 只输出我方已确认的处置措施,不得自行补充现场没有的内容;
4. 先输出文档大纲供我确认,确认后再生成完整代码。
三、完整流程(4 步)
docx_helper.py,一次建好长期复用。.docx,我通读一遍改内容细节即可。四、踩坑记录
坑 | 现象 | 解法 |
|---|---|---|
长文档语法错误 | 上百行脚本偶尔报错 | 不让 AI 重新生成,直接让它定位修复,保留已确认结构 |
内容自由发挥 | 写出现场没有的工艺 | 提示词加约束:"只写我方已确认的处置措施" |
格式漂移 | 同一份文档前后风格不一 | 强制只用辅助函数输出,禁止自由排版 |
表格需求 | 函数里没有表格 | 补一个 tbl(headers, rows) 函数,数据以列表传入 |
五、效果 一份专项施工方案从 2-3 天压缩到半天,格式零返工;后续同类型方案只改"现场条件"参数,复用率极高。
代码已实测可运行,欢迎直接抄走。有更好的工程文档生成思路,评论区交流。 #WorkBuddy #CodeBuddy
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。