通过 Skills CLI 安装
使用 npx skills add 将该 skill 安装到选中的 Agent。Phase 0 命令均为按规则生成，尚未验证。
Codex
npx skills add https://github.com/addyosmani/agent-skills/blob/main/skills/documentation-and-adrs/SKILL.md -g -a codex -y去掉 -g 可改为项目级安装
#6
该品类排名 #6 / 共 56 个· Ranked #6 of 56 in this category
documentation and adrs
Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features,…
安装前须知Before you install
✓未声明特殊权限需求No special access needs declared
编辑结论· Editor's verdict
Auto-published by GitHub discovery based on star threshold.
✓
适合什么场景Best for
- High-star GitHub skill discovery candidate.
✗
不适合什么场景Not for
- Sensitive or production workflows without local review.
vs 其他选择vs alternatives
完整对比表Full compare table →#1Anthropic Doc Coauthoring
把零散上下文写成读者真正看得懂的文档。
差异 · diff面对那种「真有人要照着做事」的长寿命文档时它最合适——RFC、设计文档、架构说明、技术规格。围绕读者测试循环展开：起草、丢给新读者、看 ta 能不能回答文档里自己提出的关键问题、再修订。Anthropic 出品，格式和评审约定和 Claude 实际消费上下文的方式对得上。一页发布说明那种小东西别用它，release-briefing 处理那种事开销更小。
#2Docs Release
代码改完就同步文档，别拖到三周之后。
差异 · diff对那种「代码改了但文字还停在去年」的文档最有效——README、架构图、上手指南这一类长寿命文档。它读 diff，找出哪些文档段落和改动有关，提出最小修改让它们重新对上。在架构重构或 API 改名潮之后效果最好；纯新文档场景不如它的兄弟 anthropic-doc-coauthoring 适合。
#3DX Audit
把文档表面看不出来的上手摩擦点显性化。
差异 · diff你需要知道新用户到底是怎么体验你产品的、而不是你的团队以为他们怎么体验的，它最有用。走一遍公开的上手路径——文档、安装、第一次 API 调用、第一条错误信息——给每一步计时。专抓那些沉默失败：文档里写了但实际不存在的功能、复制粘贴的命令在 macOS 跑不起来、默认配置 404。开发者面向产品发布前最值得跑一遍。内部工具别用它，不是为那个场景调的。
维度对比side-by-side compare
和同类的关键维度差异| 当前 · this skilldocumentation and adrs | Anthropic Doc Coauthoring | Docs Release | DX Audit | |
|---|---|---|---|---|
| 评分 · rating | — | 4.7 | 4.7 | 4.5 |
| 星标 · stars | 38k | 163k | 9.3k | 5.4k |
| 风险 · risk | 自动筛查 · automated | 低风险 · low risk | 低风险 · low risk | 低风险 · low risk |
| 最适合 · best for | High-star GitHub skill discovery candidate. | 设计文档 | README 更新 | 上手流程审计 |
| 不适合 · not for | Sensitive or production workflows without local review. | 小型变更日志修改 | 线上发布验证 | 事故响应 |
审计备注Audit notes
未独立审计 · not audited源码Source公开 GitHub · open on GitHub✓
作者Author社区贡献 · community!
网络访问Network未独立审计 · not audited!
文件写入Filesystem未独立审计 · not audited!
依赖Dependencies未独立审计 · not audited!
遥测Telemetry无 · none✓