前言¶
项目文档常见问题是「开工时写一版 README,后面只改代码不改文档」:接口变了、目录结构调整了、决策没记下来,新人或隔了几个月的自己都要重新翻提交记录。手工维护 PROJECT.md、CHANGELOG 或内部 wiki 往往靠自觉,很难和日常开发节奏对齐。
下面介绍 SkillHub 社区 Skill project-doc-memory(坐标 @user_1fa06258/project-doc-memory)。官方简介将其定位为一套 workflow:在项目生命周期内,让文档持续更新并保持有序。本文只写 SkillHub 页面与安装文档中可核对的事实;包内 SKILL.md 的具体步骤需在安装后本地查看。
这是什么¶
project-doc-memory 是发布在 SkillHub 上的 Agent Skill,版本 1.0.0,来源为 community,分类 business-ops,发布者为 user_1fa06258。页面标注 requires_api_key=false,不依赖额外 API Key。
与「一次性生成 README」不同,官方英文简介强调的是 continuously updated and organized throughout the lifecycle:把文档维护写成可重复执行的流程,交给支持 Skills 的 Agent 在对话中按技能说明执行,而不是每次从零口述要求。
核心功能(以官方简介为准)¶
公开资料未展开逐步操作清单,目前能核实的能力边界如下:
- 文档持续更新:面向项目演进,而非单次生成静态说明。
- 文档组织:强调 organized,即结构、归类或归档方式由技能包内的 workflow 定义(细节见安装后的
SKILL.md)。 - 全生命周期:覆盖从立项到迭代维护的阶段,而非只服务初始化。
除上述简介外,SkillHub 页面未列出独立脚本名、配置文件字段或固定输出路径;撰写本文时未获取到该坐标下 SKILL.md 全文,因此不描述具体目录、文件名或触发词。
安装与启用¶
安装方式遵循 SkillHub 通用说明:skillhub.cn/install/skillhub.md。页面也给出了可直接发给 AI 的提示:请根据该文档安装 @user_1fa06258/project-doc-memory。
1、安装 SkillHub CLI(若尚未安装)¶
先确认本机是否已有 skillhub:
command -v skillhub && skillhub --version
未安装时,可用官方脚本(完整安装含默认 Skill;仅需 CLI 时加 --cli-only):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录;默认装到 ./skills/ 可能不会被加载,且多数客户端安装后仍需重启。
skillhub install @user_1fa06258/project-doc-memory --dir <skills 目录>
常用路径(来自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
将 <skills 目录> 换成你当前环境对应路径即可。Codex CLI、Claude Code 与 Cursor 的差异主要体现在 skills 目录位置,安装命令形式相同。
3、启用与核对¶
安装完成后重启或重新加载 Agent,使技能被发现。在技能目录中打开 project-doc-memory 下的 SKILL.md,核对名称、description 以及 workflow 步骤是否与 SkillHub 简介一致。
典型用法¶
公开页面未提供可复制粘贴的对话示例或命令行子命令。可复现的用法只有两层:
- 按 SkillHub 指引完成 CLI 安装,把包落到正确的 skills 目录。
- 在支持 Skills 的客户端中加载该技能,按
SKILL.md中的 workflow 发起任务(例如明确要求「按 project-doc-memory 维护/更新项目文档」——具体触发表述以包内文档为准)。
若你需要确认技能是否生效,可在安装目录中检查是否存在 SKILL.md 及同目录附属文件;本文无法代替该文件中的逐步说明。
适用场景与注意¶
适合谁
- 中小团队或个人项目,希望文档跟代码一起演进,而不是大版本才补文档。
- 已在用 Cursor、Claude Code、Codex 等支持 SkillHub 安装方式的 Agent,愿意把「写文档、整理文档」交给带 workflow 的技能包。
- 分类为 business-ops,更偏向流程与运营类文档治理,而非单一技术栈脚手架。
限制与注意
- 公开资料未说明固定产出物是
PROJECT.md、docs/还是其他路径;不要假设与同名开源项目(如其他平台上的 project-memory、project-doc)行为相同。 - requires_api_key=false 只表示 SkillHub 元数据未要求配置 API Key;若 workflow 内引导调用外部服务,仍以
SKILL.md为准。 - SkillHub 页面统计(撰写时):评分 100000,下载 928,安装 2;社区来源技能,维护节奏取决于发布者。
- 安装前建议阅读 SkillHub 安装文档中的来源与版本提示;
skillhub install前确认坐标与版本 v1.0.0。
结尾¶
project-doc-memory 把「文档在项目全周期内持续更新、保持有序」写成可安装的 Agent workflow,适合想把文档维护从偶发劳动变成固定流程的开发者。安装与坐标以 SkillHub 为准。