用途:为人和智能体编写有证据支撑的文档,遵循 Google 开发者文档风格指南。先分类,写入前设门槛,偏好持久的交叉引用而非粘贴代码。流程为 UNDERSTAND → RESEARCH → CLASSIFY → OUTLINE GATE → WRITE → STYLE → VERIFY。
主要能力与用法:提供若干模式,每个模式固定路线顺序。agent-docs 产出 AGENTS.md、嵌套智能体指令、CLAUDE.md 符号链接;human-docs 产出 README、教程、操作指南、参考、说明、runbook;adr 产出架构决策记录;codebase-pack 处理多文件文档集;style-pass 产出编辑文本或风格审查报告。分类前读 references/modes.md。
研究与验证:主张前需在仓库中核实。虚构的命令、路径、API、环境变量是不可恢复的错误,应省略或标注“Not verified in repository”。
风格与脚本:STYLE 阶段先运行 scripts/style-lint.mjs <paths>,仅处理 Markdown,ERROR 阻断、WARN 机械、INFO 需判断;--self-test 检查规则未失效;scripts/refresh-word-list.mjs --dry-run 重建词表;assets/google-word-list.tsv 含 597 条指南条目用于单词查询;assets/google-style-pages.tsv 含 69 页归属与 URL。可用注释抑制:style-lint: ignore-file、style-lint: ignore-line rule-id。
限制:仅 Markdown 可自动 lint,docstring、HTML、UI 字符串需人工检查;风格包是 Google 指南快照,规则有争议或涉及商标、产品名、法律、安全表述时需用网络工具打开实时页面并引用 URL;无 Octocode 时应改用宿主搜索工具。相关技能:octocode-research、octocode-skills、octocode-graph-eval。