文档管理专家，负责维护项目的 docs/ 目录和 CLAUDE.md 索引。用户通过 slash command 主动触发，可能的场景包括：根据技术文档整理规范文档、根据代码整理规范文档、新功能开发后补充文档、修改代码后更新文档。
文档管理专家，负责维护项目的 docs/ 目录和 CLAUDE.md 索引。用户通过 slash command 主动触发，可能的场景包括：根据技术文档整理规范文档、根据代码整理规范文档、新功能开发后补充文档、修改代码后更新文档。
npx skills add https://github.com/stvlynn/FuzzCode --skill docs-manager复制此命令并粘贴到 Claude Code 中以安装该技能
| name | docs-manager |
| description | 文档管理专家，负责维护项目的 docs/ 目录和 CLAUDE.md 索引。用户通过 slash command 主动触发，可能的场景包括：根据技术文档整理规范文档、根据代码整理规范文档、新功能开发后补充文档、修改代码后更新文档。 |
Skill Directory:
.agents/skills/docs-manager/All bundled resource paths below (scripts, references, assets) are relative to this directory.
维护项目文档，确保文档与代码实现保持一致。文档是代码仓库的核心和灵魂。
明确用户想要记录什么内容：
tree docs
通过目录树判断是否已有相关文档：
原则：最小改动，不做非必要改动
核心原则：拆分的目的是让 code agent 按需读取，避免读到大量无关内容。
判断是否需要拆分：
使用场景是否一致（最重要）
主题是否紧密相关
行数作为辅助参考
拆分示例：
# UI_PATTERNS.md 的拆分分析
章节 1-7（头像、标签、图标）→ 写列表/卡片组件时需要
章节 8-11（管理端页面、表格）→ 写管理后台时需要
章节 12（思考过程）→ 写对话组件时需要
分析：使用场景有差异，但内容都是 UI 规范，可以保持一个文档
结论：暂不拆分，通过章节标题定位即可
拆分策略：
按使用场景拆分（推荐）
层级引用结构
层级引用示例：
# CLAUDE.md 中
- [意图控制](docs/features/intent-control/README.md) - 意图识别与路由
# docs/features/intent-control/README.md 中
## 详细文档
- [Intent Router](INTENT_ROUTER.md) - Two-Pass 意图路由引擎
- [意图配置](INTENT_CONFIG.md) - 意图库管理
触发条件：
整理策略：
增加子目录
# 整理前
docs/features/
├── agent-edit.md
├── agent-list.md
├── agent-config.md
└── ...
# 整理后
docs/features/agent-management/
├── README.md # 概述 + 索引
├── AGENT_EDIT.md # 编辑功能
└── AGENT_CONFIG.md # 配置功能
使用 archive 子目录
archive/docs/features/observability/archive/README.md 作为目录索引
README.md在完成内容编写后，检查文档行数：
wc -l <文档路径>
| 行数 | 状态 | 处理方式 |
|---|---|---|
| < 300 | ✅ 良好 | 无需处理 |
| 300-600 | ⚠️ 关注 | 检查使用场景是否一致 |
| 600-1000 | ⚠️ 评估 | 分析是否有不同使用场景的内容 |
| > 1000 | ❌ 强烈建议拆分 | 大概率存在可拆分内容 |
注意：行数只是参考，核心判断标准是"使用场景一致性"。
⚠️ 对 CLAUDE.md 的改动务必慎重，只能修改文档索引部分，不可修改其他无关内容。
需要更新的情况：
操作原则：最小改动
# 一级标题（文档名）
## 二级标题（主要章节）
### 三级标题（子章节）
// apps/web/src/pages/xxx/index.tsx
export function XxxPage() { ... }
apps/web/src/components/ 而非绝对路径文档是精简的规范文档，目的是让 AI/开发者按规范写代码，保证风格一致。
好的规范文档结构：
# 功能/模块名
> 一句话说明
---
## 核心规范
### 规范 1：XXX
**规则**：具体要求
```tsx
// ✅ 正确写法
代码示例
// ❌ 错误写法
反例代码
...
| 模块 | 路径 | 说明 |
|---|---|---|
| 前端页面 | pages/xxx/ | ... |
| 后端服务 | services/xxx.ts | ... |
Q: ... A: ...
## 注意事项
- 文档是给 AI Agent 和开发者看的，要简洁明了
- 避免冗余，一个信息只在一处记录
- 优先记录"怎么做"而非"是什么"
- 规范类文档要有具体示例
- 功能文档要说明核心代码路径
Creates, reviews, and debugs UI motion and animation implementations. Covers springs, gestures, drag interactions, clip-path reveals, easing, timing, and animation review. Use when designing, implementing, or reviewing motion, CSS transitions, keyframes, framer-motion, spring animations, asking "add animations to", "make this feel smooth", "review my animations", "should this animate", or "add a swipe gesture"
Tldraw's UI design system. Use when building interfaces inspired by Tldraw's aesthetic - light mode, Inter font, 4px grid.
