前言¶
交付或内审前，团队往往要补齐需求规格、设计说明、API 说明、测试与部署类文档。这些材料若全靠人工从代码里反推，耗时长，格式也容易前后不一致。下面介绍 SkillHub 上的社区 Skill「项目文档生成专家」：在 Agent 对话里触发后，由 Skill 引导自动分析当前项目代码，并按固定模板生成多套文档，并支持版本管理。
这是什么¶
「项目文档生成专家」是 SkillHub 社区来源（community）的 Agent Skill，坐标为 @user_dd91c74f/project-doc-generator，当前页面版本为 v1.0.3，发布者为 user_dd91c74f，分类为 dev-programming。页面标注 requires_api_key=false，安装与使用不依赖额外 API Key。
它面向「已有代码、缺成套项目文档」的场景：用自然语言触发 Skill，让 Agent 按 Skill 内定义的流程分析仓库并落盘文档，而不是从零手写每一章。
官方页面：
- SkillHub：https://www.skillhub.cn/skills/user_dd91c74f/project-doc-generator
- API 入口：https://api.skillhub.cn/user_dd91c74f/project-doc-generator
核心功能¶
依据官方简介与 SkillHub 页面，已核实的能力如下。
- 代码分析：自动分析项目代码（具体扫描范围与深度由 Skill 内
SKILL.md及 Agent 执行环境决定）。 - 七套标准文档：一次流程可生成下列文档类型——需求规格、概要设计、详细设计、数据库设计、API 文档、测试计划、部署手册与用户手册。
- 版本管理：支持对生成结果做版本管理（具体目录命名与增量规则以安装后的 Skill 说明为准）。
- 触发短语：当用户说「形成项目文档」或「生成项目文档」时，Agent 应调用该 Skill（官方简介中的 Invoke 说明）。
安装与启用¶
Skill 基于通用 SKILL.md 格式，需安装到当前 Agent 能识别的 skills 目录；装错目录会导致 Agent 无法加载。
方式一：SkillHub CLI¶
先确认是否已安装 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（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
安装本 Skill 时必须使用 --dir 指向当前环境的 skills 目录。官方安装说明中的常用路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例（将 <skills 目录> 换成上面对应路径）：
skillhub install @user_dd91c74f/project-doc-generator --dir <skills 目录>
安装后若 Agent 未立即识别新 Skill，按所用客户端说明重启或刷新会话。
方式二：让 Agent 按官方指引安装¶
SkillHub 页面提供的安装提示为：让 AI 根据 https://skillhub.cn/install/skillhub.md 安装 @user_dd91c74f/project-doc-generator。在 Cursor 等支持 Skills 的客户端中，可将该句直接发给 Agent，由 Agent 读取安装文档并执行 skillhub install 与目录配置。
典型用法¶
- 在已打开目标项目的工作区中启用该 Skill（完成上一节安装）。
- 在对话中说明意图，使用官方触发语之一，例如：
- 「生成项目文档」
- 「形成项目文档」 - 按 Agent 提示确认分析范围（模块、分支、是否覆盖数据库与 API 等），等待其根据代码生成七类文档并写入约定输出位置。
- 若需保留多轮迭代结果，利用 Skill 声明的版本管理能力区分各次生成（具体以 Skill 内文档为准）。
官方未提供独立命令行「一键出 doc」示例；可复现路径是：安装 Skill → 在项目上下文中用触发语发起任务。
适用场景与注意¶
适合谁
- 需要快速补齐立项、验收或协作所需的规范文档，且仓库结构相对清晰的后端、全栈或带 API 的项目。
- 已在 Cursor、Claude Code、Codex 等支持 SkillHub skills 目录的 Agent 环境中工作的开发者。
使用上需注意
- 生成内容质量取决于代码可读性、注释与项目规模；复杂业务规则仍需人工校对，不宜未经审核直接作为正式交付物。
skillhub install必须指定正确的--dir，否则默认装到./skills/可能不被当前 Agent 加载。- 社区来源 Skill，升级与行为变更以 SkillHub 上 v1.0.3 及后续版本为准；安装前可在页面查看评分与下载量（页面展示为评分 100000、下载 5403，数据随 SkillHub 更新而变化）。
结尾¶
「项目文档生成专家」把「从代码反推文档」收成可重复的 Agent 工作流：七类标准文档加版本管理，用「生成项目文档」或「形成项目文档」即可唤起。安装与优先源配置以 SkillHub 文档为准：https://skillhub.cn/install/skillhub.md ；Skill 详情页：https://www.skillhub.cn/skills/user_dd91c74f/project-doc-generator 。
