技术写作

seo 技能可用于审计、规划和落地技术 SEO、页面优化、结构化数据、Core Web Vitals 和关键词映射。适合用于抓取可访问性、索引可访问性、元数据、schema、内链、sitemap 和 robots 变更，或面向 Keyword Research 的 SEO 工作，并提供可直接执行、按页面拆解的指导。

java-coding-standards 技能为 Spring Boot 服务中的 Java 17+ 提供实用指南，涵盖命名、不可变性、Optional、streams、异常、generics 和包结构布局，帮助你编写更易读、易维护的代码。适用于编码、重构，以及用于 Code Review 的 java-coding-standards。

cpp-coding-standards 是一份基于 C++ Core Guidelines 的 C++ 编码规范指南。适合用于现代 C++ 的编写、审查和重构，重点关注安全性、清晰度、可维护性、RAII、类型安全和良好设计。非常适合用于 Code Review 中的 cpp-coding-standards，以及团队在实际场景中的决策参考。

code-tour 可创建可复用的 CodeTour `.tour` 文件，并包含真实的文件与行号锚点。需要引导式序列而不是平铺式总结时，可使用 code-tour 技能来做入门导览、架构走读、PR 导览、RCA 路径，以及面向 Technical Writing 的 code-tour。

article-writing 技能可帮助起草长篇内容，兼顾清晰结构、稳定文风与事实依据。适用于文章、指南、教程、新闻简报，以及 Copywriting 工作流中的 article-writing 场景，尤其适合需要精修、可直接发布文稿的任务。

architecture-decision-records 可在 Claude Code 会话中以结构化 ADR 的形式捕捉架构决策。它会识别决策时刻，记录上下文、备选方案和决策理由，并保留一份 ADR 日志，方便后续维护者查阅。适合需要长期保留决策历史的 Technical Writing 和工程团队。

api-design 是一款用于 REST API 设计的技能，帮助你规划和审查端点、资源命名、状态码、分页、过滤、版本管理和错误响应。

brainstorming 是一项面向实现前阶段的技能，用于梳理上下文、逐条提出澄清问题，并要求在任何代码编写之前先完成设计确认。它还包含可选的 visual companion，并对 Requirements Planning 提供了较强支持。

writing-plans 可将 spec 或需求文档整理为可执行的详细实现计划，包含文件级指导、任务排序、测试步骤，以及在正式编码前使用的评审提示。

doc-coauthoring 提供一套用 AI 协作起草文档的结构化流程，涵盖上下文收集、迭代式大纲设计、分节写作与读者测试，适合产出可评审的 specs、RFCs 和 proposals。

technical-writer 是一款轻量级文档技能，用于产出更清晰的 README、API docs、setup guides、tutorials、onboarding 文档和 release notes。它将 Technical Writing 聚焦在用户目标、快速上手、示例与故障排查上。该技能以单个 `SKILL.md` 文件交付，不依赖额外脚本或模板。

document-release 是一项发布后文档更新技能，它会读取项目文档、对照已交付的 diff，并更新 README、ARCHITECTURE、CONTRIBUTING、CLAUDE.md、CHANGELOG 和 VERSION，确保文档与实际发布内容一致。对于代码已合并、需要一份可靠的 document-release 指南的技术写作场景，请使用这项技能。

caveman 是一种超精简沟通技能，适合简洁的技术回复、摘要和排障帮助。它会保留技术含义，去掉冗余内容，并在触发后持续生效，直到你说 stop caveman 或 normal mode。最适合技术写作、代码审查备注、事故更新，以及当你已经熟悉主题时更快的来回沟通。

edit-article 技能可帮助你重构现有草稿、提升表达清晰度并压缩冗余内容。适用于你需要一份可靠的 edit-article 指南来修订文章时，尤其是在重视章节顺序和依赖关系的技术写作流程中。

writing-shape 是一项对话式起草技能，用于把 markdown 原始材料整理成可发布的文章。它适合处理开头选择、按段落展开、结构取舍等工作，适用于技术写作、访谈笔记、录音转写清理和粗稿润色。如果你需要的是有引导的编辑流程，而不是一次性提示词，那么可以用 writing-shape 指南。

grill-with-docs 是一项用于规划与文档的技能，会把你的方案放到仓库现有的领域模型里做压力测试，打磨术语，并在决策逐渐明确时同步更新 CONTEXT.md 和 ADRs。适合 Technical Writing、偏产品思维的工程协作，以及任何比起只靠 prompt 头脑风暴，更重视与仓库语境一致的语言表达的工作流。

ubiquitous-language 是一款 DDD 风格技能，用于从对话中提取共享术语表，标记歧义词和同义词，并生成 UBIQUITOUS_LANGUAGE.md。适合用来定义领域术语、统一团队认知，并改进 Technical Writing 中的 ubiquitous-language。

python-code-style 用于处理 Python 格式化、lint、命名规范、类型提示和 docstring。适合用于 pull request 审查、统一团队编码约定，以及在 `pyproject.toml` 中配置 ruff、mypy 或 pyright 的使用规范。

architecture-decision-records 可帮助团队起草并维护 ADR，以清晰呈现背景、决策、备选方案和影响，形成更持久、可追溯的技术决策文档。

changelog-automation 技能可帮助团队围绕 Keep a Changelog、SemVer、release notes 和 Conventional Commits 设计变更日志工作流。你可以用它规划安装与使用场景、明确输入要求，并提升 Technical Writing 与开发者文档中的发布说明一致性。

add-educational-comments 技能可在保持代码结构和行为不变的前提下，为指定代码文件添加以教学为导向的注释。若未提供目标文件，它会提示用户选择文件；同时还能根据读者水平调整注释方式，并遵循清晰的行数增长限制，适合教育型代码编辑场景。

gws-docs 通过 gws CLI 帮你读取和编辑 Google Docs，并提供方法级控制，支持创建、获取和批量更新。技术写作和文档自动化场景下，可按照 gws-docs 指南中的安装、schema 和用法流程进行操作。

adr-skill 可帮助团队创建和维护可供智能体执行的 Architecture Decision Records。它支持起草 ADR、初始化 ADR 目录、选择模板、更新状态，并通过检查清单、脚本和示例来校验决策。

clarify 可优化容易引起困惑的 UX 文案、错误消息、标签、引导步骤和操作说明，让用户更少靠猜就能完成动作。它适合技术写作、支持内容以及需要把界面文案写得更清楚的产品团队。这个技能会先明确上下文、受众和用户状态，再进行改写，因此输出会更直接、更具体，也更便于实际使用。