第 4 章 · 03 六个示例技能精读

第 4 章 · 03 六个示例技能精读

本节摘要:原书附带六个生产级技能。code-review-specialist(安全/性能/质量/可维护性四维审查+摘要评分输出);blog-draft(9 步博客流水线:建目录→研究存摘要→头脑风暴→提纲→git 提交提纲→草稿 v0.1→审阅迭代→强制行内引用);brand-voice(品牌语气一致性+推荐/避免词汇表,user-invocable: false 只让 Claude 自动调用);claude-md(CLAUDE.md 最佳实践专家,create/update/audit 三模式);doc-generator(从源码生成逐端点 API 文档);refactor(Fowler 六阶段重构流水线+10 种异味表+"没有测试的重构就像没系安全带开车")。每个技能都示范了一个主题:把专家方法论编译成可执行流程。

学习目标

阅读完本节,你应当能够:

1. 复述 code-review-specialist 的四维审查框架与输出模板。
2. 复述 blog-draft 九步流水线,说出"强制引用"与"git 提交提纲"的作用。
3. 说出 brand-voice 的词汇表机制与 user-invocable 设计。
4. 复述 refactor 的六阶段与安全规则(没测试不重构/小步/失败即回滚)。

一、code-review-specialist:四维审查

• 安全:认证授权、数据泄露、注入、密码学、敏感日志;
• 性能:Big O、内存、DB 查询、缓存、并发;
• 质量:SOLID、设计模式、命名、文档、覆盖率;
• 可维护性:可读性、函数 <50 行、圈复杂度、依赖、类型安全。

输出模板:摘要(1-5 分)+ 关键问题(问题/位置/影响/严重性 Critical-High-Medium/修复示例)+ 分类发现。

二、blog-draft:九步博客流水线

1. 建 YYYY-MM-DD-slug/ 文件夹(含 resources/);
2. 研究抓取,存摘要 source-N-*.md;
3. 头脑风暴+澄清问题(核心结论、长度 500-800/1000-1500/2000+);
4. 提纲;
5. 存 OUTLINE.md;
6. git 提交提纲——锚点:内容变动有据可查;
7. 写 draft-v0.1.md;
8. git 提交;
9. 审阅迭代(v0.2...;更新旧文则跳过 0-8 直接步骤 9)。

强制引用:统计/比较/事实必须行内引用 [1] 或 [Source Name],文末参考资料列表——把事实核查写进流程,而不是依赖自觉。

三、brand-voice:品牌语气一致

user-invocable: false——仅 Claude 自动调用。内容:使命/价值观(简洁、可靠、赋能);语气(友好专业、清晰、自信、同理心);写作指南(用"你"、主动语态、句 <20 词);推荐 vs 避免词汇表("Claude" 不写 "the Claude AI"、"Agent" 不写 "bot";避免 cutting-edge/game-changer/leverage/utilize/paradigm shift);好/坏示例对比。示范:把品牌规范编译成 AI 可执行的规则表。

四、claude-md:CLAUDE.md 最佳实践专家

create/update/audit 三模式,内容即第 3 章黄金法则的完整版(150-200 指令上限、少即是多、不自动生成等),含 AGENTS.md 处理(@AGENTS.md 导入或软链)。示范:用技能承载"元知识"——教 Claude 怎么写好 CLAUDE.md。

五、doc-generator:文档生成

从源码生成 API 文档:OpenAPI/Swagger、端点文档、SDK 示例、集成指南、错误码、认证指南;给出逐端点的 Markdown 模板(描述/参数表/成功+错误响应 JSON/cURL+JS+Python 示例)。

六、refactor:六阶段重构流水线

1. 研究分析:先问范围/目标/约束/时间压力/测试状态;
2. 测试覆盖评估:"没有测试的重构就像没系安全带开车";
3. 识别异味:10 种异味表 + scripts/detect-smells.py;
4. 创建重构计划:异味→手法映射表(长函数→Extract Method);分 A 快速收益/B 结构/C 架构三阶段;
5. 增量实施:"修改→测试→通过?→提交→下一步"红绿循环;
6. 评审迭代:analyze-complexity.py 对比指标。

安全规则:没测试不重构、小步、每步测试、失败即回滚、不臆测。

小结

六个技能的共同模式:专家方法论 → 分步流程 → 可执行脚本 → 模板输出。它们证明了一件事:任何有章法的工作(审查/写作/重构/文档)都可以编译成技能,让 Claude 按专家标准执行。下一节是技能的使用规范:最佳实践与共享。