前言¶
軟件交付階段,測試報告和操作手冊幾乎是每個項目都要交的文檔。麻煩不在內容,在格式:封面左上角的元數據塊、底部兩列簽章表、文檔控制記錄、目錄層級、測試清單的對齊方式,人工在 Word 裏逐頁調整既慢又容易出錯,而且同一套規範在不同人手裏會調出不同結果。
下面介紹的 Skill 把這套規範固化成生成規則:按任務關鍵字分流,直接產出符合規範的 .docx,省掉排版返工。
這是什麼¶
這是一個 SkillHub 上的社區 Skill,座標 @user_3efd9dc7/hzxdeliverydoc-generator-v20,名稱「軟件實施類文檔編寫」,當前版本 2.1.1,分類 office-efficiency,發佈者 user_3efd9dc7。它解決的問題是:交付文檔格式規範固定、重複勞動多,人工排版成本高且結果不一致。
基本屬性(來自 SkillHub 頁面抓取):
名稱: 軟件實施類文檔編寫
版本: 2.1.1
來源: community
分類: office-efficiency
requires_api_key: false(無需 API Key)
評分: 100000
下載: 1106
核心功能¶
它按固化規範生成兩類 Word 文檔(.docx),下面分別介紹。
1. 系統功能測試報告類¶
覆蓋系統測試報告、UAT 測試報告、功能測試報告三個名稱,文檔結構按以下順序生成:
- 封面:左上角 5 行元數據塊 + 2 行主標題 + 底部 2 列簽章表,整體排在同一頁;
- 文檔控制記錄;
- 目錄;
- 測試背景;
- 測試清單:序號列 + 事項列,事項居左;
- 功能測試詳述:按三段式編寫。
2. 操作手冊類¶
覆蓋操作手冊、使用手冊、用戶手冊三個名稱,v2.0 起支持。
樣式與分流規則¶
兩類文檔共用一套樣式基線與通用紅線,不各自另起一套格式。分流方式是任務關鍵字:提示中包含「測試報告」的按測試報告規範生成,包含「操作手冊」的按手冊規範生成。
另外附 39 條歷史踩坑避坑清單,生成或修訂文檔時可對照檢查。
安裝與啓用¶
官方資料中未給出具體的安裝命令。該 Skill 基於通用 SKILL.md 格式,按你所用客戶端加載技能的方式,把技能目錄放入對應位置後即可在對話中調用。啓用前確認兩件事:
- 客戶端支持 SKILL.md 格式的技能加載;
- 該 Skill 無需 API Key(requires_api_key=false),不會因密鑰缺失而調用失敗。
官方地址與座標:
SkillHub 頁面: https://www.skillhub.cn/skills/user_3efd9dc7/hzxdeliverydoc-generator-v20
API 地址: https://api.skillhub.cn/user_3efd9dc7/hzxdeliverydoc-generator-v20
座標: @user_3efd9dc7/hzxdeliverydoc-generator-v20
Cursor、Codex CLI、Claude Code 各自的安裝路徑在官方資料中未分別說明,這裏不做推測,以客戶端官方文檔爲準。
典型用法¶
用法就是發任務,靠關鍵字命中對應規範。兩個可復現的示例。
生成測試報告:
幫我生成一份 UAT 測試報告,系統爲 XX 平臺,涵蓋登錄、查詢、導出功能。
命中「測試報告」關鍵字,套用測試報告規範。產出的 .docx 已包含封面(元數據塊 + 主標題 + 簽章表同頁)、文檔控制記錄、目錄、測試背景、測試清單和功能測試詳述,無需再手工排版。
生成操作手冊:
寫一份操作手冊,面向使用 XX 系統的業務人員。
命中「操作手冊」關鍵字,套用手冊規範。
需要留意的是,規範是固化的:封面五行元數據塊、兩列簽章表、清單列對齊方式等都按既定規範生成。如果項目要求偏離這套規範,需要自行修改生成結果。
適用場景與注意¶
適合誰:軟件實施、交付團隊,需要批量、穩定地產出同一套格式規範的測試報告與操作手冊。規範統一本身就是它的價值。
實際使用中的幾條注意點:
- 提示裏必須帶上能命中的關鍵字(「測試報告」或「操作手冊」),否則不會套用對應規範;
- 同類文檔的不同叫法(系統測試報告 / UAT 測試報告 / 功能測試報告,操作手冊 / 使用手冊 / 用戶手冊)都映射到各自類別,措辭不影響分流;
- 生成前建議先對照附隨的 39 條歷史踩坑避坑清單,可以減少返工;
- 該 Skill 來自社區(community),版本 2.1.1;評分 100000、下載 1106 爲抓取時點頁面數據。
結尾¶
這個 Skill 的價值在於把交付文檔的格式規範變成固定的生成規則:不用在 Word 裏逐頁調封面、簽章表和目錄,帶上關鍵字發任務,產出的 .docx 直接符合既定規範,39 條避坑清單還能順帶減少歷史問題的重複發生。
官方地址:https://www.skillhub.cn/skills/user_3efd9dc7/hzxdeliverydoc-generator-v20