关于 document-writer
document-writer 是一项用于编写技术文档的技能，面向需要组织项目、接口或操作说明的作者。它涵盖多种文档类型，并强调清晰、完整和易于查阅。
主要功能
- 01编写 README、API 文档和用户手册
- 02组织技术规范与架构说明
- 03按目标读者规划文档结构
- 04提供示例并检查边界情况
- 05优化标题与内容导航
适用场景
- 01为项目编写 README 和快速开始指南
- 02整理接口参数、响应格式与错误码
- 03制作操作手册和故障排除说明
- 04记录架构设计、数据模型与流程
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/document-writer确认已加载。
详细介绍
来自项目 README文档编写技能
本技能提供专业的技术文档编写能力。
支持的文档类型
1. README 文档
- 项目简介
- 安装说明
- 快速开始
- 配置选项
- API 参考
- 贡献指南
2. API 文档
- 接口描述
- 请求/响应格式
- 参数说明
- 错误码
- 使用示例
3. 用户手册
- 功能介绍
- 操作步骤
- 常见问题
- 故障排除
4. 技术规范
- 架构设计
- 数据模型
- 流程图
- 接口规范
写作原则
清晰性
- 使用简洁明了的语言
- 避免歧义和模糊表达
- 提供具体示例
完整性
- 覆盖所有必要信息
- 包含先决条件
- 说明边界情况
可用性
- 逻辑结构清晰
- 易于导航
- 提供搜索友好的标题
文档模板
README 模板
# 项目名称
简短描述（一句话）
## 特性
- 特性 1
- 特性 2
## 安装
\`\`\`bash
npm install xxx
\`\`\`
## 快速开始
\`\`\`javascript
// 示例代码
\`\`\`
## 配置
| 参数 | 类型 | 默认值 | 描述 |
|------|------|--------|------|
| ... | ... | ... | ... |
## 许可证
MIT
使用流程
- 确定文档类型和目标读者
- 收集必要信息
- 按模板结构组织内容
- 审查和优化表达
- 添加示例和图表
评论
支持 Markdown