前言¶
写代码时，文档往往是最先被砍掉的一环。时间紧，先跑通功能；代码「自文档化」，命名清楚就够了；这个需求下个迭代再补文档。等到要交付、要交接、要排查线上问题时，README 缺一块、API 说明对不上实现、技术指南只剩几行，返工成本远高于当时补文档的成本。
文档助手（Skill 坐标 @user_3c47cf70/doc-writer）就是针对这个痛点设计的：凡是涉及创建文档、README 文件、API 文档、代码注释或技术指南的场景，它都会介入，防止遗漏文档、确保覆盖完整，并且要求在编写代码的同时编写文档，不因时间压力、「自文档化」声明或范围限制而豁免。
这是什么¶
文档助手是一个基于通用 SKILL.md 格式的 Agent Skill，用于在开发过程中强制、完整地产出配套文档。
- 名称：文档助手
- 坐标：@user_3c47cf70/doc-writer
- 官方地址：https://api.skillhub.cn/user_3c47cf70/doc-writer
- SkillHub 页面：https://www.skillhub.cn/skills/user_3c47cf70/doc-writer
- 版本：1.0.0
- 来源：community
- 分类：dev-programming
- 发布者：user_3c47cf70
- 标签：requires_api_key=false
- 评分：100000（SkillHub），下载 1090 次，安装 0 次
它解决的问题很单一：文档不是开发流程的可选项，而是与代码同批交付的一部分。
核心功能¶
根据官方简介，文档助手的能力集中在三件事上：
- 防止遗漏文档。触发场景覆盖文档、README 文件、API 文档、代码注释和技术指南，要求在这些场景下必须产出对应文档，而不是默认跳过。
- 确保全面覆盖。文档需要覆盖的对象要完整，不能只写一部分、留几个「TODO」充当文档。
- 强制代码与文档同批编写。写代码的同时写文档，明确不因时间压力、「自文档化」这类说法或范围限制而延后，即不承认「先写代码、后补文档」的常见做法。
安装与启用¶
目前公开资料（SkillHub 页面与官方接口信息）只给出了坐标 @user_3c47cf70/doc-writer 和地址 https://api.skillhub.cn/user_3c47cf70/doc-writer，没有提供可直接复制的安装命令。
该 Skill 基于通用 SKILL.md 格式，启用方式取决于你使用的 Agent 客户端：
- 使用 SkillHub 相关客户端时，按坐标
@user_3c47cf70/doc-writer添加该 Skill。 - 手动使用时，将该 Skill 的 SKILL.md 放入对应客户端的 Skills 目录，或通过
/skills命令安装。 - 官方页面标注 requires_api_key=false，使用时不需要额外配置 API Key。
本文不写未经官方资料核实的具体命令，避免给出无法验证的安装步骤。
典型用法¶
文档助手的使用方式是触发式的：当任务涉及创建文档、README 文件、API 文档、代码注释或技术指南时，由 Agent 加载该 Skill，按其规则执行。
可以复现的用法是：在提出开发需求时，同时说明需要交付的文档类型，例如：
- 新增一个服务模块，要求同时产出 README、接口文档和关键代码注释。
- 修改现有 API，要求同步更新 API 文档中的参数与返回值说明。
- 写技术方案或技术指南，要求覆盖背景、设计、使用方式和边界条件。
在这些场景下，文档助手会要求 Agent 把文档与代码作为同一交付物处理，而不是等到代码写完再回头补。
适用场景与注意¶
适合谁：
- 在迭代节奏快、文档容易被压缩的团队里负责代码交付的开发者。
- 需要同时维护 README、API 文档、代码注释和技术指南，且希望 Agent 主动提醒不要漏项的人。
- 想把「写文档」明确写进开发流程，而不是靠个人习惯维持的团队。
使用上的限制和注意点：
- 评分与下载数据来自 SkillHub 页面，安装量为 0，说明实际使用反馈样本很少，不要据此判断其实际效果。
- 它属于 community 来源，发布者为 user_3c47cf70，使用前建议先查看其规则内容。
- 强制写文档会带来额外的篇幅与时间成本，对一次性原型、实验性代码这类场景可能并不划算，可以按需跳过。
- 「自文档化」被该 Skill 明确列为不构成豁免的理由，如果你的代码确实依赖清晰命名和类型系统自解释，需要自己权衡是否启用。
小结¶
文档助手的价值在于把文档从「有空再补」变成开发流程中的强制步骤：覆盖文档、README、API 文档、代码注释和技术指南，要求与代码同批编写，不接受时间压力或「自文档化」作为跳过理由。
官方地址：https://api.skillhub.cn/user_3c47cf70/doc-writer
