1. 先把需求看清楚這個(gè)案例到底解決什么問(wèn)題1.1 從“手動(dòng)寫報(bào)告”到“自動(dòng)出報(bào)告”的轉(zhuǎn)變這個(gè)案例我前前后后折騰了大概三天核心就一件事讓 Claude Code 在收到一堆原始素材之后自動(dòng)產(chǎn)出排版規(guī)范、結(jié)構(gòu)完整、可以直接交付的 Word 報(bào)告。可能有人會(huì)問(wèn)直接用 ChatGPT 網(wǎng)頁(yè)版生成一段 Markdown 再手動(dòng)復(fù)制到 Word 不行嗎行但如果報(bào)告每周都要出、格式要求還特別死板比如固定的一級(jí)標(biāo)題黑體三號(hào)、二級(jí)標(biāo)題黑體四號(hào)、正文宋體小四、表格三線表樣式、頁(yè)碼位置固定那你就會(huì)發(fā)現(xiàn)靠人工搬運(yùn)的每一分鐘都是浪費(fèi)。這個(gè)案例里Claude Code 做的事情不是“生成一段文字”而是“調(diào)用我預(yù)先定義好的技能”把原始數(shù)據(jù)、會(huì)議紀(jì)要、測(cè)試日志甚至圖片整理成一份帶目錄、帶樣式、帶自動(dòng)編號(hào)的 Word 文件。先說(shuō)結(jié)論這套方案的實(shí)測(cè)效果是把原本手工需要 1 到 2 小時(shí)的報(bào)告整理工作壓縮到了 3 到 5 分鐘。中間踩過(guò)的坑不少尤其是 Word 表格列寬、公式圖片、空白頁(yè)這類經(jīng)典問(wèn)題后面我會(huì)逐條展開。1.2 為什么選 Claude Code 而不是別的自動(dòng)化方案市面上做自動(dòng)化的工具很多腳本、Excel 宏、Python 模板、低代碼平臺(tái)都能做報(bào)告生成。但這個(gè)案例選 Claude Code是因?yàn)樗摹爸悄荏w”模式天然適合處理非結(jié)構(gòu)化輸入。手動(dòng)寫腳本方案的問(wèn)題是報(bào)告的內(nèi)容結(jié)構(gòu)稍微一變腳本就要跟著改。比如這個(gè)月多了一個(gè)“風(fēng)險(xiǎn)項(xiàng)”章節(jié)下個(gè)月的報(bào)告需要把“結(jié)論”提到前面模板腳本維護(hù)成本立刻就上來(lái)了。Claude Code 的優(yōu)勢(shì)在于它本身是一個(gè)運(yùn)行在終端里的 AI 智能體你可以用自然語(yǔ)言給它分配任務(wù)它自己會(huì)決定先讀哪個(gè)目錄、調(diào)用哪個(gè)函數(shù)、檢查哪份材料再按照你定義的技能規(guī)范輸出結(jié)果。這里需要特別提一下“技能”這個(gè)概念。在 Claude Code 的機(jī)制里技能不是一段簡(jiǎn)單的 Prompt而是一個(gè)帶目錄結(jié)構(gòu)、帶說(shuō)明文件、附帶可執(zhí)行腳本的完整工具包。你可以在項(xiàng)目里通過(guò)SKILL.md文件來(lái)描述這個(gè)技能做什么、有哪些約束、需要調(diào)用哪些腳本。Claude Code 讀到這個(gè)技能之后會(huì)把技能里的規(guī)則當(dāng)作“工作手冊(cè)”來(lái)執(zhí)行。這跟 CTFHub 技能樹那種“知識(shí)地圖”完全是兩種東西——CTFHub 技能樹是給人學(xué)習(xí)用的體系化知識(shí)索引而這里的技能是給 AI 智能體用的工作流程定義。兩者名字里都帶“技能”但面向?qū)ο蠛陀猛就耆煌?. 環(huán)境準(zhǔn)備與技能設(shè)計(jì)Claude Code 側(cè)的核心配置2.1 安裝 Claude Code 與模型接入安裝 Claude Code 本身不難如果你用過(guò) npm那基本就是一條命令的事npm install -g anthropic-ai/claude-code裝完先跑一下claude --version確認(rèn)版本號(hào)正常然后直接輸入claude進(jìn)入交互終端。首次啟動(dòng)會(huì)讓你登錄授權(quán)這里要注意服務(wù)的可用性跟區(qū)域有關(guān)。如果你在啟動(dòng)時(shí)看到類似“might not be available in your country”的提示說(shuō)明當(dāng)前網(wǎng)絡(luò)環(huán)境不在官方支持范圍內(nèi)。這種情況下最穩(wěn)妥的做法是確認(rèn)官方支持地區(qū)列表或者等待服務(wù)覆蓋范圍擴(kuò)展后再試。安全提示先放最前面不要為了繞過(guò)地區(qū)限制去折騰代理連接服務(wù)器、虛擬機(jī)鏡像繞行、DNS 解析調(diào)整之類的手段。這類操作既不穩(wěn)定也容易踩法律和合規(guī)的線解決問(wèn)題的正路是選一個(gè)官方支持的區(qū)域或等待服務(wù)擴(kuò)展。配置完成后還可以在~/.claude/settings.json里做個(gè)性化調(diào)整比如默認(rèn)模型、輸出風(fēng)格、是否需要自動(dòng)接受工具調(diào)用等。我的建議是新手期不要開啟全自動(dòng)工具調(diào)用先讓它每一步都問(wèn)你一遍確認(rèn)它的行為習(xí)慣之后再放權(quán)。2.2 技能的設(shè)計(jì)思路把“算報(bào)告”變成“工廠流水線”技能設(shè)計(jì)是這個(gè)案例里最核心的環(huán)節(jié)。我的思路是把報(bào)告生成拆成四個(gè)階段——素材解析、框架搭建、內(nèi)容填充、格式渲染。素材解析讀取用戶指定的文件夾或文件識(shí)別出里面的數(shù)據(jù)表、文本記錄、圖片素材?？蚣艽罱ǜ鶕?jù)報(bào)告類型生成固定的章節(jié)結(jié)構(gòu)比如背景、數(shù)據(jù)概覽、問(wèn)題分析、結(jié)論建議。內(nèi)容填充把解析出來(lái)的數(shù)據(jù)放進(jìn)去調(diào)用圖表生成腳本把圖表路徑寫進(jìn)報(bào)告框架。格式渲染最后統(tǒng)一調(diào)用定制好的 Word 生成腳本保證每個(gè)標(biāo)題、每個(gè)表格都符合規(guī)范。這四步如果不拆分全部塞進(jìn)一個(gè) Prompt 里讓 Claude Code 自由發(fā)揮效果會(huì)非常不穩(wěn)定。它可能這次生成的 Markdown 結(jié)構(gòu)很好下次就輸出一堆不規(guī)范的內(nèi)容。拆分成技能之后每個(gè)環(huán)節(jié)都有明確輸入輸出任何一步出錯(cuò)都能單獨(dú)排查。2.3 技能目錄結(jié)構(gòu)與 SKILL.md 的寫法技能的本質(zhì)其實(shí)是一個(gè)約定目錄。我在項(xiàng)目里建了這樣的結(jié)構(gòu)skills/ report-generator/ SKILL.md scripts/ generate_docx.py chart_render.py data_parser.py templates/ report_template.docx cover_page.docx assets/ example_output.docxSKILL.md是給 Claude Code 看的說(shuō)明書一定要寫得像“給新員工看的操作手冊(cè)”不能太抽象。以下是我實(shí)際在用的縮減版# 技能名稱報(bào)告生成器 ## 技能目標(biāo) 根據(jù)用戶提供的素材目錄自動(dòng)生成一份符合 XX 企業(yè)標(biāo)準(zhǔn)的 Word 周報(bào)。 ## 觸發(fā)條件 當(dāng)用戶提到“生成周報(bào)”“出報(bào)告”“自動(dòng)報(bào)告”時(shí)使用本技能。 ## 工作流程 1. 首先調(diào)用 scripts/data_parser.py 解析輸入目錄下的所有 .xlsx / .csv / .txt 文件。 2. 如果解析失敗立即返回錯(cuò)誤信息不要繼續(xù)后續(xù)步驟。 3. 根據(jù)解析結(jié)果調(diào)用 scripts/chart_render.py 生成圖表保存到臨時(shí)目錄。 4. 最后調(diào)用 scripts/generate_docx.py 生成 Word 報(bào)告。 ## 格式規(guī)范 - 一級(jí)標(biāo)題黑體三號(hào)居中 - 二級(jí)標(biāo)題黑體四號(hào)左對(duì)齊 - 正文宋體小四1.5 倍行距 - 表格標(biāo)準(zhǔn)三線表 - 頁(yè)腳頁(yè)碼居中 ## 關(guān)鍵約束 - 不允許修改模板文件 templates/report_template.docx - 生成的報(bào)告必須包含封面、目錄頁(yè)、正文、附錄四個(gè)部分 - 遇到任何數(shù)據(jù)缺失請(qǐng)?jiān)趫?bào)告“風(fēng)險(xiǎn)項(xiàng)”章節(jié)中明確標(biāo)注寫完這個(gè)文件之后每次在 Claude Code 對(duì)話里提到“生成周報(bào)”它就會(huì)自動(dòng)讀取該技能并按照里面的約束執(zhí)行。這里有一個(gè)非常值得記錄的細(xì)節(jié)如果技能文件寫得像“作文提綱”Claude Code 就會(huì)自由發(fā)揮但如果寫得像“SOP 操作流程”它的輸出質(zhì)量會(huì)穩(wěn)定得多。跟人共事的道理是一樣的規(guī)則越清晰產(chǎn)出越可控。3. 實(shí)操讓 Claude Code 真正生成帶格式 Word 報(bào)告3.1 用 python-docx 控制樣式、表格與分頁(yè)技能里的核心腳本是generate_docx.py基于 python-docx 實(shí)現(xiàn)。用這個(gè)庫(kù)而不是直接讓 Claude Code 自己拼 XML是因?yàn)樗橄髮哟魏线m既能控制樣式又不像底層操作那樣容易出錯(cuò)。先看如何控制標(biāo)題樣式。python-docx 默認(rèn)模板的樣式名跟 Word 中文版不完全一致所以最直接的方式是先加載已有的模板再修改樣式from docx import Document from docx.shared import Pt from docx.enum.text import WD_ALIGN_PARAGRAPH doc Document(templates/report_template.docx) styles doc.styles # 修改一級(jí)標(biāo)題樣式 h1 styles[Heading 1] h1.font.name 黑體 h1.font.size Pt(16) # 三號(hào)約等于16pt h1.font.color.rgb RGBColor(0, 0, 0) h1.paragraph_format.alignment WD_ALIGN_PARAGRAPH.CENTER # 修改正文樣式 normal styles[Normal] normal.font.name 宋體 normal.font.size Pt(12) # 小四約等于12pt normal.paragraph_format.line_spacing 1.5這里有一個(gè)容易踩坑的點(diǎn)font.name 黑體只設(shè)置了西文字體中文字體需要在rPr元素里額外指定w:eastAsia否則生成的 Word 文檔里中文仍然顯示默認(rèn)字體。from docx.oxml.ns import qn def set_font(run, name_cn, name_en, size, boldFalse): run.font.name name_en run._element.rPr.rFonts.set(qn(w:eastAsia), name_cn) run.font.size size run.font.bold bold這個(gè)函數(shù)是我寫完整套腳本之后總結(jié)出來(lái)的通用工具后面的標(biāo)題、正文、表格單元格文字都靠它來(lái)統(tǒng)一設(shè)置字體。3.2 表格列寬設(shè)置poi 是 Java 的標(biāo)準(zhǔn)答案有朋友在評(píng)論區(qū)問(wèn)過(guò)“Java POI 能生成圖表嗎”答案是能POI 完全可以操作 Word 文檔里的圖表對(duì)象但開發(fā)周期比 Python 長(zhǎng)很多。如果你已經(jīng)在用 Claude Code 做自動(dòng)化腳本語(yǔ)言選 Python 會(huì)順手得多。不過(guò)涉及 Word 表格列寬問(wèn)題的時(shí)候Python 和 Java 的思路是通用的。python-docx 里設(shè)置表格列寬不能只設(shè)置column.width因?yàn)?Word 表格的寬度同時(shí)受單元格、表格布局、網(wǎng)格列三個(gè)因素影響。正確寫法是這樣table doc.add_table(rowslen(data), cols3) table.style Table Grid # 關(guān)閉自動(dòng)調(diào)整 table.autofit False # 設(shè)置每個(gè)單元格的寬度 widths [C