该技能提供文档编写的技术写作模式与准确性核查,适用于编写文档、创建运行手册或记录系统架构的场景。
主要能力与配套资源:部署架构图技能用于生成系统文档与运行手册的架构图;AWS 知识接口在编写架构文档或运行手册时引用官方文档,建议链接而非转述;文档加载 MCP 服务器用于加载 PDF、网页等外部参考资料;无服务器插件用于记录无服务器模式、Lambda 配置与 SAM 部署步骤;AWS 数据库插件用于记录 DSQL 模式设计、查询模式与迁移流程;context7 MCP 用于核对库/框架文档以验证 README 示例的技术准确性;评论分析器插件在文档写完后核查准确性、过时风险与可维护性;GitHub 插件用于关联 issue、PR 与讨论,并为文档缺口建 issue。
它还给出 README 结构(项目名、单行说明、快速开始、配置表、用法、开发、许可证)、API 文档最低要求(HTTP 方法与路径、请求参数、响应码与模式、鉴权、示例)、运行手册模板(概览、架构、健康检查、常见问题、升级路径)、ADR 模板,以及 spec 驱动工作流中各产物(spec.md、design.md、tasks.md、review.md、sa-review.md、decisions.md)的归属与用途。
使用方式上,devops-agent 负责 README、运行手册与架构文档并使其贴近代码,coding-agent 在实现期间编写内联文档,两者写完文档后委托评论分析器核查准确性;GitHub 插件用于为待更新文档建 issue。写作建议包括先讲“是什么”和“为什么”、用具体示例、保持可扫读、随代码更新文档、避免填充内容,并优先用图表而非文字描述架构。
限制:资料未提供具体安装命令、收费与价格信息。