技术写作

seo 技能可協助稽核、規劃並落實技術型 SEO、頁面內優化、結構化資料、Core Web Vitals 與關鍵字對應。適用於可爬取性、可索引性、metadata、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、型別安全與良好設計。很適合將 cpp-coding-standards 用於 Code Review 與團隊實務決策。

code-tour 會建立可重複使用的 CodeTour `.tour` 檔案，並附上真實的檔案與行號錨點。當你需要的是一段有引導順序的內容，而不是扁平摘要時，可用 code-tour 技能來製作 onboarding 導覽、架構導覽、PR 導覽、RCA 路徑，以及 Technical Writing 的 code-tour。

article-writing 技能可協助撰寫結構清晰、語氣一致且有證據支撐的長篇內容。適合用於文章、指南、教學、電子報，以及需要潤飾成可發布成品的 Copywriting 工作流程中的 article-writing。

architecture-decision-records 可在 Claude Code 工作階段中，以結構化 ADR（Architecture Decision Records）方式記錄架構決策。它能辨識需要做決定的時刻，記錄背景、替代方案與決策理由，並保留 ADR 日誌，方便未來維護者查閱。適合需要長期保存決策脈絡的技術寫作與工程團隊。

api-design 是一個專注於 REST API 設計的 skill，適合用來規劃與審查 endpoints、資源命名、狀態碼、分頁、篩選、版本控管與錯誤回應。

brainstorming 是一項實作前技能，會先釐清情境脈絡、一次只提出一個澄清問題，並要求在任何程式碼撰寫前先完成設計核准。另包含可選用的 visual companion，並對 Requirements Planning 提供完整支援。

writing-plans 可將 spec 或需求文件整理成可執行的詳細實作計畫，包含檔案層級指引、任務排序、測試步驟，以及正式開始寫程式前的審查提示。

doc-coauthoring 提供一套以 AI 協作撰寫文件的結構化流程，從蒐集脈絡、反覆整理大綱、逐節撰寫到讀者測試，適合產出可供審閱的 specs、RFCs 與 proposals。

technical-writer 是一款輕量級文件撰寫 skill，適合用來產出更清楚的 README、API 文件、安裝與設定指南、教學內容、新人上手文件與版本說明。它將 Technical Writing 聚焦在使用者目標、快速開始、實例示範與疑難排解，並以單一 SKILL.md 檔案交付，不需額外腳本或範本。

document-release 是一個針對發佈後文件更新的技能，會讀取專案文件、對照已交付的 diff，並更新 README、ARCHITECTURE、CONTRIBUTING、CLAUDE.md、CHANGELOG 和 VERSION，讓文件與實際發佈內容一致。當程式碼已經合併完成，而你需要一份可靠的 document-release 指南時，技術寫作就很適合使用這個技能。

caveman 是一種超精簡的溝通技能，適合用來產出精簡的技術回覆、摘要與除錯協助。它會保留技術含意、刪掉贅字，而且在觸發後會持續生效，直到你說出 stop caveman 或 normal mode。最適合 Technical Writing、code review 註記、事故更新，以及當你已經熟悉主題時，想要更快來回溝通的情境。

edit-article 技能可協助你重組既有草稿、提升清晰度，並讓文字更精煉。當你需要一份可靠的 edit-article 指南來修訂文章時，特別是在技術寫作工作流程中、章節順序與相依關係很重要的情境下，這項技能會很有用。

writing-shape 是一個對話式起稿 skill，適合把 markdown 原始素材整理成可發佈的文章。它可協助你挑選開頭、逐段展開內容，以及為 Technical Writing、訪談筆記、逐字稿清理和粗稿做結構取捨。當你需要的是有引導的編輯流程，而不是一次性的 prompt 時，就適合使用 writing-shape guide。

grill-with-docs 是一個規劃與文件化技能，會把你的方案放進 repo 既有的領域模型中壓力測試，釐清術語，並在決策逐漸明朗時同步更新 CONTEXT.md 與 ADRs。適合技術寫作、重視產品思維的工程協作，以及任何比起只靠提示詞腦力激盪，更看重以 repo 為基礎語言的工作流程。

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 設計 changelog 工作流程。可用於規劃安裝與導入情境、定義使用輸入，並提升 Technical Writing 與開發者文件中的 release notes 一致性。

add-educational-comments 技能可在指定程式碼檔案中加入以教學為導向的註解，同時保留原有結構與行為。若未提供檔案，它會要求你指定目標檔案；也會依讀者程度調整說明深度，並遵循清楚的行數增幅限制來進行教學型程式碼編修。

gws-docs 可讓你透過 gws CLI 讀寫 Google Docs，並提供方法層級控制，支援建立、擷取與批次更新。請依照 gws-docs 指南中的安裝、schema 與使用流程，將它用於技術寫作與文件自動化。

adr-skill 可協助團隊建立與維護可供代理執行的 Architecture Decision Records。它支援起草 ADR、初始化 ADR 資料夾、挑選範本、更新狀態，並透過檢查清單、腳本與範例驗證決策內容。

clarify 可改善讓人看不懂的 UX 文案、錯誤訊息、標籤、導覽流程與操作指引，讓使用者更少猜測就能採取行動。它很適合技術寫作、支援內容，以及需要更清楚介面文字的產品團隊。這個技能會先釐清情境、受眾與使用者狀態，再進行改寫，因此產出的內容會更直接、更具體，也更好用。