一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | brand-docx（合集仓库子技能，见下方说明） | 仓库目录结构 |
| 项目自述名称 | BrandDocs（仓库整体品牌名，涵盖 brand-docx / brand-pptx / brand-xlsx 三个姊妹技能） | README |
| 所属仓库 | ferdinandobons/brand-docs | GitHub |
| 作者/维护者 | Ferdinando Bonsegna（个人开发者，GitHub 账号创建于 2022 年，自述专注 AI Agent 与 Claude Skill 开发） | GitHub API |
| 来源链接 | https://github.com/ferdinandobons/brand-docs/tree/main/skills/brand-docx | — |
| 许可证 | MIT | GitHub API + LICENSE 文件 |
| 仓库整体 Stars/Forks | 218 / 26（注：该数字属 BrandDocs 整个三技能产品包，非 brand-docx 单项数字；但三者共享同一引擎与同一仓库，并非互不相关的“合集”） | GitHub API |
| 最新版本 | v0.10.1（2026-07-10 发布，近两个月内发布 10 个版本） | GitHub Releases |
| 安装方式 | Claude Code 插件市场一条命令；Codex 需克隆仓库并建立软链接（见第十章） | 官方 README |
二、功能介绍与亮点
brand-docx 先从一份真实的企业 Word 模板中提取主题色、字体、命名样式、结构、封面锚点、图片与表格，生成可复用的“品牌档案”；此后每次生成新文档都直接复用原模板外壳与已提取样式，不由模型凭空编造颜色或字体——README 称之为“离题输出在架构上不可能发生”。核心流程为 extract →（可选）comprehend → verify → generate，另有 learn/propose-overrides/refine 三个学习动词，把历史 QA 发现与用户反馈沉淀回档案。
亮点：①三层 QA + 900 余条测试，README 明确 docx 是已验证到位的“参考实现”；②纯本地运行，不依赖云端，真实模板默认被 .gitignore 排除；③内置合成示例模板，无需自备品牌文件即可试用；④verify 会在档案指向模板中不存在的元素时主动拒绝，把“防跑偏”做成硬约束。
三、适用场景
固定分类：文档与办公自动化
适用于：企业需要用同一套 Word 模板反复产出结构与视觉风格一致的报告、信函、备忘录等场景；也适合需要保留原模板页眉页脚、封面版式与公司标准字体配色、又不想每次手工排版的用户。受益人群：需要用公司Word/PPT/Excel模板批量产出品牌一致文档的团队。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | README 提供 /plugin marketplace add 与 /plugin install 官方安装步骤 |
| Codex | 支持（需手动配置） | README 提供专门的 git clone + venv + 软链接安装步骤 |
| OpenClaw | 未验证 | 公开材料未提及专门支持或安装步骤 |
| Hermes Agent | 未验证 | 同上 |
五、推荐理由
从真实模板萃取品牌规范并原样复现,生成同格式新文档
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 218 星、26 Fork，创建仅约6周即达到此规模、增长较快；但主要为单一开发者项目，第三方独立讨论证据薄弱，故不进入 7 分档 |
| 可用性 | 8 | 文档详尽（含安装、示例、架构说明多份文档），近两个月发布 10 个版本、维护频繁；开源免费无付费依赖；但需要 Python 环境与可选的 LibreOffice/Poppler 系统依赖才能获得完整视觉校验，非一条命令直接可用 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 7.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 仅通过本地 scripts/cli.py 调用 Python 引擎处理文件读写，SKILL.md 明确禁止猜测更深层路径，范围可控 |
| ② 运行时联网外发 | SECURITY.md 与 SKILL.md 均未见任何云端调用，明确定位为本地优先 |
| ③ API Key/凭据 | 不需要任何 API Key 或凭据 |
| ④ 可疑指令排查 | 已完整抓取 SKILL.md 与 SECURITY.md 全文，未发现 prompt injection 或隐藏指令迹象 |
| ⑤ 作者/组织信誉 | 个人开发者，GitHub 账号自 2022 年持续活跃，专精 AI Agent 技能开发，非匿名新账号 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 最近一次发布为 2026-07-10，近期维护活跃 |
安全策略文档专门列出 OOXML 解析中的 XXE、压缩炸弹、zip-slip 路径穿越等风险并说明已加校验，属主动的威胁建模而非事后声明，故定为 9 分。
七、跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| docx（Anthropic 官方） | 从零生成/编辑通用 Word 文档，把格式陷阱写成规则清单 | 不学习复用既有模板的品牌样式，格式要求需在提示词中描述 |
| tfriedel/claude-office-skills | 第三方 Word/PPT/Excel/PDF 全家桶 | 面向通用文档生成，作者已建议改用官方版本，近3个多月未见新提交 |
| appautomaton/document-SKILLs | 基于官方 docx/pptx/xlsx/pdf 技能改编，新增表单与修订痕迹处理 | 仍是通用文档编辑增强，不具备提取并复用品牌样式的能力 |
核心差异化：brand-docx 把“复用企业真实模板的品牌样式”做成架构级保证，而非提示词层面的努力方向，与通用文档生成类 skill 是场景互补而非替代关系。
八、用户评价
该技能目前在第三方平台尚无可独立验证的具名用户评价；仓库 Issue 区主要为作者本人记录的开发任务与一条来自其他项目的合作邀约，均不构成对该技能使用体验的第三方评价。
九、其他补充
仓库另含 brand-pptx、brand-xlsx 两个姊妹技能，三者共享同一 Python 引擎，安装时需拉取整个仓库而非单独复制某个技能目录。README 明确当前仅 docx 达到“参考实现”成熟度，pptx/xlsx 仍在追赶功能对等程度。
十、安装使用方式
Claude Code（插件市场）：
/plugin marketplace add ferdinandobons/brand-docs
/plugin install brand-docs@brand-docsCodex 及其他兼容 Agent：
git clone https://github.com/ferdinandobons/brand-docs.git ~/.codex/brand-docs
cd ~/.codex/brand-docs && python3 -m venv .venv && . .venv/bin/activate && pip install -r requirements.txt
mkdir -p ~/.codex/skills
ln -s ~/.codex/brand-docs/skills/brand-docx ~/.codex/skills/brand-docx安装后注意事项：无需重启；需安装 requirements.txt 中的 Python 依赖，若要保留默认开启的可视化质检（推荐），还需安装 LibreOffice 与 Poppler，可用 scripts/setup_visual_qa.sh 自动检测安装，python scripts/brandkit/cli.py doctor 随时自查环境。首次为新模板建档约需15分钟，之后基于同一模板生成文档只需数秒。
十一、注意事项
- 项目自评为“Alpha，持续成熟中”：docx 已是验证充分的参考实现，pptx/xlsx 功能对等程度仍在追赶；
- 完整功能依赖 LibreOffice、Poppler 等系统级工具，不同操作系统下的安装体验可能有差异；
- 该技能是合集仓库中的子技能，来源链接务必使用本报告给出的子目录级链接，而非仓库根链接；
- OpenClaw、Hermes Agent 的兼容性暂无可验证材料，如需在其他 Agent 环境使用请自行测试。