关于 documentation
documentation 是面向不同读者编写和维护技术文档的技能，涵盖多种常见文档类型。它强调实用的信息组织、示例、内容更新，以及通过链接避免重复。
主要功能
- 01README 和 API 文档指南
- 02运行手册与架构文档框架
- 03入门指南结构
- 04以读者为中心的写作原则
- 05用示例和链接减少重复
适用场景
- 01撰写项目 README
- 02记录 API 端点和错误
- 03创建运维运行手册
- 04编写架构或入门指南
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/documentation确认已加载。
详细介绍
技术文档
为不同受众和用途编写清晰、易于维护的技术文档。
文档类型
README
- 这是什么，为什么存在
- 快速开始（5 分钟内即可首次成功）
- 配置与使用
- 贡献指南
API 文档
- 带请求/响应示例的端点参考
- 身份验证与错误码
- 速率限制与分页
- SDK 示例
运行手册
- 何时使用本运行手册
- 前置条件与所需权限
- 分步操作流程
- 回滚步骤
- 升级路径
架构文档
- 背景与目标
- 带图表的高层设计
- 关键决策与权衡
- 数据流与集成点
入职指南
- 环境搭建
- 关键系统及其连接方式
- 常见任务的操作演练
- 各类问题的咨询对象
原则
- 为读者而写：谁在读，他们需要什么？
- 先给出最有用的信息：不要把重点埋没
- 展示，而非诉说：代码示例、命令、截图
- 保持内容更新：过时的文档比没有文档更糟
- 链接而非重复：引用其他文档，而不是复制内容
评论
支持 Markdown