前言¶
售前、交付或内部立项时，经常要在短时间内交出一份章节完整、格式像样的技术方案。手写往往卡在结构不统一、架构图和表格反复改、最后还要按公文样式排 Word。通用对话式提示词能写出片段，但很难稳定覆盖十五个章节，也未必能落到可下载的 .docx。
下面介绍 SkillHub 上的「解决方案专家」（@user_b7657b26/solution-cgl）。它用标准 SKILL.md 约定输入、章节骨架和 Word 转换优先级，让 Agent 按同一套流程生成方案并尽量输出政府文档风格的 Word 文件。
这是什么¶
「解决方案专家」是社区来源（community）的 Agent Skill，坐标 @user_b7657b26/solution-cgl，当前版本 1.0.5，分类为 business-ops，发布者为 user_b7657b26。SkillHub 页面标注 requires_api_key=false，安装后无需单独配置 API Key。
技能包内的 SKILL.md 标题为「技术方案编写技能」。定位可以概括为：
- 输入：需求文档（经
parse_file解析）或用户的自然语言描述。 - 输出：以 15 个章节为主线的技术方案，并优先交付 Word（完整版约 50–80 页量级，精简版约 15–25 页），而不是只给 Markdown。
官方入口：
- SkillHub 展示页：https://www.skillhub.cn/skills/user_b7657b26/solution-cgl
- API 坐标页：https://api.skillhub.cn/user_b7657b26/solution-cgl
（截至资料抓取时，SkillHub 显示评分 100000、下载 1539、安装 15。）
核心功能¶
以下能力均来自技能包 SKILL.md 与目录结构，可按安装后的文件自行核对。
双版本输出¶
| 版本 | 章节 | 适用场景 | 页数（技能内说明） |
|---|---|---|---|
| 完整版 | 15 章全部 | 投标、正式评审 | 50–80 页 |
| 精简版 | 1–4、5、8、11、14 等 8 块内容 | 汇报、快速预览 | 15–25 页 |
生成时可在对话中指定版本，例如「生成精简版技术方案」。
固定执行流程¶
- 解析需求（文档或描述，信息不足时使用
[xxx]占位）。 - 按章节模板生成方案正文（项目概述、需求分析、总体架构、技术选型、功能模块、数据与安全、部署与接口、性能、实施与运维、预算、风险、附录等）。
- 必须将 Markdown 转为 Word，并按优先级尝试转换方式。
- 返回 Word 路径供下载（技能要求格式类似
[技术方案_xxx.docx](computer://路径)）。
内容与版式约束¶
- 正文以段落为主，表格仅用于对比、清单、配置等场景。
- 架构与流程默认提供 ASCII 图，并可选附带 Mermaid；若环境有
drawio-generator技能且用户要求可编辑图，可尝试生成.drawio，否则降级为 ASCII + Mermaid。 - 预算金额使用占位符
[xxx万元]，不编造具体数字；技能内附有小型/中型项目费用参考区间表，并注明以市场/招标为准。 - Word 需符合技能内「政府文档」字体字号表（如标题黑体、正文宋体、页边距与行距等），推荐通过
references/政府文档模板.docx做 pandoc 引用。
附带资源与脚本¶
安装目录通常包含：
references/模板.md、references/模板-精简版.md：章节框架。references/示例-*.md：完整示例（用于对齐文风与深度）。scripts/md_to_docx.py、scripts/check.py等：Markdown 转 Word 与检查辅助。
安装与启用¶
SkillHub 官方安装说明见：https://skillhub.cn/install/skillhub.md
1. 检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能无法被识别。
skillhub search solution-cgl
skillhub install solution-cgl --namespace user_b7657b26 --dir <你的 skills 目录>
也可让 Agent 按安装文档执行：根据 https://skillhub.cn/install/skillhub.md 安装 @user_b7657b26/solution-cgl。
常用客户端 skills 路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
安装后按你所用客户端要求刷新或重启 Agent，使技能被加载。
3. 运行环境（Word 转换）¶
技能要求最终交付 Word。转换优先级为：
- pandoc（推荐，引用政府模板）
- 系统预置的 docx 技能（
skill_load("docx")） python scripts/md_to_docx.py（依赖 python-docx）
若三者均不可用，技能允许降级为仅输出 Markdown，并明确告知用户当前环境无法自动转 Word。
典型用法¶
从需求文档生成完整版¶
- 将需求文档放在 Agent 可读路径，并说明项目名称与交付格式要求。
- 触发技能后，Agent 应解析文档并生成 15 章 Markdown，再执行 Word 转换。
pandoc 示例（路径以你本地生成文件为准）：
pandoc 技术方案.md -o 技术方案.docx --reference-doc=references/政府文档模板.docx
- 在对话中获取
.docx下载路径；技能建议的目录形态为：技术方案/[项目名称]/技术方案_[项目名称]_[日期].docx。
快速汇报用精简版¶
在需求描述中写明「生成精简版技术方案」。技能会只保留精简版所列章节（概述、需求、架构、选型、功能模块简化、部署、实施里程碑、风险等），页数目标在技能内为 15–25 页。
质量自检¶
生成后技能自带检查项，例如：15 章是否齐全、各章是否有实质内容、架构图是否可读、预算是否为占位符、技术选型是否与项目类型一致。Word 转换后还需核对标题/正文字体与表格边框是否符合政府文档表。
适用场景与注意¶
适合谁
- 需要反复产出结构化技术方案的售前、解决方案、项目经理或研发负责人。
- 输入以需求说明、招标文件摘录或会议纪要为主，希望 Agent 按统一目录写满再出 Word。
- 政企或类似场景，需要接近公文排版的 Word，而不是纯聊天里的 Markdown。
限制与注意
- 技能强调必须尝试 Word 输出；本机未装 pandoc、无 docx 技能、又无 python-docx 时，只能得到 Markdown 降级结果。
- 预算、部分量化指标依赖占位或参考区间，不能当作真实报价；正式投标前仍需人工审核与补数。
drawio-generator、全局docx技能是否可用取决于你当前 Agent 环境，技能已写明降级策略。- 社区 Skill，能力边界以包内
SKILL.md与references/为准；SkillHub 公开展示页未展开长文说明时，应以安装后的文件为权威。
结尾¶
「解决方案专家」把「解析需求 → 十五章（或精简八块）→ Word 政府文档样式 → 可下载路径」写成固定流水线，适合把技术方案写作从即兴对话改成可重复执行的 Skill 工作流。无需 API Key，通过 SkillHub CLI 安装到对应 Agent 的 skills 目录即可使用。
官方地址：https://www.skillhub.cn/skills/user_b7657b26/solution-cgl
