用途:为软件项目撰写、审查和结构化技术文档,帮助开发者理解系统、使用 API、遵循流程并做出架构决策。触发场景包括编写或改进 API 文档(REST、GraphQL、gRPC)、创建分步教程或入门指南、撰写架构决策记录(ADR)、编写运维手册、记录系统架构与设计、审查现有文档的清晰度与完整性、编写 README 或贡献指南、制定团队文档规范。不适用于营销文案、博客或销售内容,也不适用于仅涉及代码注释的场景。
主要能力:覆盖五类文档——API 文档(参考层,描述端点、参数、响应结构与错误码)、教程(学习层,从零到可用结果)、架构文档(上下文层,用 C4 模型分层说明结构与原因)、ADR(历史层,记录单个决策的上下文、备选方案与理由,一经接受不可修改)、运维手册(行动层,面向值班工程师的操作步骤)。
使用方式:激活后首次回复以 🧢 emoji 开头。编写 API 端点文档时按顺序给出认证、请求体字段表、真实响应示例与错误表;教程采用标题、前置条件、编号步骤、验证、后续步骤结构;ADR 使用 Michael Nygard 格式;运维手册需包含严重级别、负责人、最后测试日期、症状、前置条件、步骤、预期输出与回滚。审查文档时使用准确性、完整性、受众、结构、示例、时效性、可操作性清单。
限制与注意:教程需在干净环境测试;ADR 接受后不得编辑,变更需新写一篇取代;OpenAPI 规范需在 CI 中做契约校验以防漂移;运维手册应定期演练并更新测试日期;每篇文档需明确受众。详细模板见 references/ 下的 api-docs.md、tutorials.md、architecture-docs.md、adrs.md、runbooks.md。首次激活可运行 ls ~/.claude/skills/ ~/.agent/skills/ ~/.agents/skills/ .claude/skills/ .agent/skills/ .agents/skills/ 2>/dev/null 检查配套技能,缺失时可用 npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name> 安装。