前言¶
在 Cursor、Claude Code 等工具里写代码时，模型往往只能看到当前打开的文件和零散上下文。仓库里若没有统一的「给 AI 看的说明」，每次对话都要重复讲技术栈、目录约定和协作规则，既费事也容易前后不一致。
常见做法是手写根目录下的指引文件（例如各客户端约定的 AGENTS.md），再补若干子文档。这对成熟项目可行，但对新仓库或长期缺文档的老项目，从零搭结构仍然耗时。下面介绍 SkillHub 上的社区 Skill project-doc-init：在用户提出初始化项目文档等需求时，由 Agent 按 Skill 指引分析仓库并生成文档体系。
这是什么¶
project-doc-init（坐标 @user_81da3431/project-doc-init，当前版本 1.2.2）由社区发布者 user_81da3431 维护，分类为 dev-programming，来源标注为 community。它面向「需要一次性搭好 AI 开发文档结构」的场景：自动分析项目，并生成以 AGENTS.md 为入口、配套子文档组成的文档体系。
Skill 基于通用 SKILL.md 格式，标签标明 requires_api_key=false，安装与使用不依赖额外 API Key。
官方页面：SkillHub - project-doc-init
核心功能¶
依据 SkillHub 简介与页面说明，已核实的能力如下。
- 自动分析项目：结合仓库现状推断结构，为后续文档落点提供依据（具体扫描范围与规则以 Skill 包内
SKILL.md为准）。 - 生成 AGENTS.md：在仓库中创建或初始化面向 AI 助手的根级指引文件。
- 配套子文档：在 AGENTS.md 之外生成与项目匹配的子文档，形成可拆分的文档体系，便于模型按主题读取。
- 意图触发：当用户需要初始化项目文档、创建 AGENTS.md、设置 AI 开发文档结构，或提到「项目文档」「开发文档」「初始化文档」等表述时，适合启用该 Skill。
页面未单独列出各子文档的文件名清单；成稿结构以安装后 Skill 实际执行为准。
安装与启用¶
SkillHub 推荐两种方式：让 AI 按安装文档操作，或在本机用 skillhub CLI 安装到当前 Agent 的 skills 目录。
方式一：提示词交给 AI¶
将下面意图发给已接入 Skill 能力的 Agent（安装步骤以 SkillHub 官方文档为准）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_81da3431/project-doc-init`。
方式二：skillhub CLI¶
先做环境检查；未安装 CLI 时按官方脚本安装，再把 Skill 装到当前客户端的 skills 目录（装错目录 Agent 可能识别不到）。
command -v skillhub && skillhub --version
# 未安装 CLI 时（完整安装，含默认 Skill）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时务必指定 --dir，例如：
skillhub install @user_81da3431/project-doc-init --dir <skills 目录>
常见客户端 skills 路径（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安装或更新 Skill 后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 生效。
典型用法¶
官方页面未提供逐步截图教程，可复现的入口如下。
- 在目标项目仓库中打开 Agent（Cursor、Claude Code 等已配置好对应 skills 目录）。
- 用自然语言说明需求，例如：「帮我初始化这个项目的开发文档」「创建 AGENTS.md 并搭好 AI 文档结构」。
- Agent 在匹配到 project-doc-init 后，按 Skill 内流程分析仓库并写入 AGENTS.md 及子文档。
- 人工通读生成结果，按团队规范增删章节，再将 AGENTS.md 纳入版本管理。
经过上面的步骤，新成员或新会话中的模型可以先读 AGENTS.md，再按需打开子文档，减少重复交代项目背景的成本。
适用场景与注意¶
适合谁
- 新仓库需要快速建立「给 AI 看」的文档骨架。
- 老项目文档缺失或分散，希望统一入口文件与子文档结构。
- 团队使用多种 AI 编码工具，希望根指引文件名与生态习惯一致（本 Skill 明确以 AGENTS.md 为入口，与部分资料中写的 CLAUDE.md 命名不同，以 SkillHub 简介为准）。
限制与注意
- 生成内容是起点，不能替代人工对安全、部署、合规等章节的审核。
- 自动分析对单仓库语言、单体/ monorepo 等形态的效果取决于项目复杂度；生成后应核对路径、命令是否与真实构建方式一致。
- SkillHub 页面统计（评分、下载量等）会变动；撰写时页面显示评分为 100000，下载 665 次，安装计数 0——仅作商店热度参考，不代表质量背书。
- 社区来源（community）意味着维护节奏与 Issue 响应以发布者为准，升级前可在 SkillHub 查看版本 1.2.2 是否有更新说明。
结尾¶
project-doc-init 把「分析仓库 + 生成 AGENTS.md 与配套子文档」收敛成可触发的 Skill 工作流，适合在项目文档空白或需要统一 AI 指引结构时使用。安装与坐标以 SkillHub 为准：
- 技能页：https://www.skillhub.cn/skills/user_81da3431/project-doc-init
- API 坐标页：https://api.skillhub.cn/user_81da3431/project-doc-init
