User Guide

---

zhaoxuya520 Updated 12.8k repo stars

File contents

--- name: user-guide description: 用户手册编写时使用。适用于操作指南 / 截图 / FAQ / 教程。

user-guide

适用场景

  • 用户手册编写时使用。适用于操作指南 / 截图 / FAQ / 教程。

核心原则

1. 读者优先(不是作者方便)
2. 可搜索 / 可导航
3. 保持更新(过期文档 = 误导)
4. 示例 > 描述
5. 图表辅助理解
```n
## 配套模板

- `templates/user-guide-template.md`

## 质量自检

```text
[] 读者明确
[] 结构清晰
[] 示例完整
[] 可搜索
[] 保持更新
```n
## 常见坑

1. 写完不更新
2. 没有示例
3. 太长没导航
4. 术语不一致
5. 敏感信息泄露

## 与其他 skill 的协作

```text
上游:各工作流 → 技术输入
下游:用户 / 团队 → 消费文档
```n

zhaoxuya520/ai-fullstack-delivery-workflow/tree/main/workflows/technical-writer/skills/user-guide commit 8d00764e4d

Frequently asked questions

npx skillmds@latest add zhaoxuya520/user-guide