关于 add-documentation
用于为函数生成 JSDoc 或 docstring,并添加 API 级注释。它更新代码内文档并保持行为不变,不用于内容翻译或叙述性变更日志。
主要功能
- 01生成 JSDoc 和 docstring
- 02添加 API 级注释
- 03保持代码行为不变
- 04支持选择文档风格
适用场景
- 01为代码文件中的函数添加文档
- 02为 API 实现补充注释
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cowork-os/ cowork-os --skill add-documentation安装后在 Claude Code 中输入/add-documentation确认已加载。
详细介绍
添加文档
用途
为函数生成 JSDoc/文档字符串
路由
- 使用时机:用户要求添加代码内文档、添加文档字符串或 API 级注释时使用。
- 不使用时机:不要用于内容翻译或叙述性变更日志。
- 输出:更新后的代码文件,并改进内联文档。
- 成功标准:在保留行为的同时,提高文档的清晰度和一致性。
触发示例
正向
- 此请求请使用 add-documentation 技能。
- 帮我添加文档。
- 用户要求添加代码内文档、添加文档字符串或 API 级注释时使用。
- 添加文档:提供可执行的结果。
负向
- 不要用于内容翻译或叙述性变更日志。
- 不要将 add-documentation 用于无关请求。
- 此请求不属于添加文档的范围。
- 这只是概念讨论,无需使用工具工作流。
参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| path | string | 是 | 要添加文档的文件路径 |
| style | select | 是 | 文档风格 |
运行时提示词
- 当前运行时提示词长度:523 个字符。
- 运行时提示词直接定义在
../add-documentation.json中。
评论
支持 Markdown