技能 documentation-templates
📦

documentation-templates

安全

快速创建专业文档

此技能提供即用型模板,用于 README 文件、API 文档、代码注释、变更日志和 AI 友好的文档格式。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“documentation-templates”。 使用 documentation-templates 为 Node.js API 创建 README

预期结果:

完整的 README.md,包含章节:标题 + 一句话概述、快速开始、功能、配置表、API 参考链接、贡献指南、许可证

正在使用“documentation-templates”。 使用 documentation-templates 记录 GET /users 端点

预期结果:

API 文档,包含端点描述、参数表(id: string, required)、响应代码(200, 404)和请求/响应示例

正在使用“documentation-templates”。 使用 documentation-templates 为数据库选择创建 ADR

预期结果:

ADR 文档,包含状态(Accepted/Deprecated/Superseded)、上下文(为什么需要此决策)、决策(决定了什么)、后果(权衡)

安全审计

安全
v1 • 2/24/2026

All 23 static findings are false positives. The skill contains only markdown documentation templates with no executable code. The detected patterns (external_commands, weak cryptographic algorithms, system reconnaissance) are markdown code fences, plain English text, and API documentation placeholders - not actual security risks.

1
已扫描文件
200
分析行数
0
发现项
1
审计总数
未发现安全问题

检测到的模式

External Command Execution (False Positive)Weak Cryptographic Algorithm (False Positive)System Reconnaissance (False Positive)
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

新项目设置

使用 README、API 文档和变更日志模板快速为新项目搭建文档框架。

文档标准

通过标准化模板在团队项目中保持一致的文档风格。

AI 代理集成

创建 AI 代理(如 Claude 和 Codex)能够理解并有效使用的文档。

试试这些提示

创建基础 README
使用 documentation-templates 技能为我的 [project type] 项目创建 README.md。包含快速开始、功能和配置章节。
记录 API 端点
使用 documentation-templates 技能为我的 REST API 创建 API 文档,包含 [list endpoints] 端点。
编写代码注释
使用 documentation-templates 技能为我的函数添加 JSDoc 注释,该函数 [describe function purpose]。
创建架构决策记录
使用 documentation-templates 技能为 [decision title] 创建 ADR。包含上下文、决策和后果章节。

最佳实践

  • 先添加基本章节(标题、快速开始、功能),然后再添加详细文档
  • 将模板作为起点,根据项目需求调整结构
  • 保持文档最新——过时的文档比没有文档更糟糕
  • 在文档中包含示例,帮助用户快速理解

避免

  • 不要直接复制模板而不根据项目上下文进行定制
  • 避免在面向用户的 README 文件中记录实现细节
  • 不要跳过快速开始章节——用户想要快速上手
  • 避免使用 AI 代理无法解析的过时文档格式

常见问题

此技能与哪些工具兼容?
此技能可与 Claude、Codex 和 Claude Code 一起使用。配合 Read、Glob 和 Grep 工具使用。
我需要修改模板吗?
是的,模板只是起点。需要根据具体项目需求调整占位符和结构。
我可以将此用于商业项目吗?
是的,此技能采用 MIT 许可,允许在注明出处的情况下用于商业项目。
什么是 llms.txt?
llms.txt 是一种专为 AI 爬虫和代理设计的文档格式。它提供结构化的概述,AI 模型可以轻松解析和理解。
这与自动生成的文档有何不同?
此技能提供人工编写的模板,优先考虑清晰度和可扫描性。自动生成的文档通常缺乏适当的结构和上下文。
此技能可以生成实际代码吗?
不,此技能仅生成文档结构和模板。它不产生可执行代码。

开发者详情

文件结构

📄 SKILL.md