Skills For Real Engineers

知名 TypeScript 专家 Matt Pocock 近日开源了他日常开发中使用的 AI 智能体技能集——Skills For Real Engineers。这套工具旨在解决当前 AI 辅助编程中常见的“氛围编程”（Vibe Coding）陷阱，即过度依赖 AI 生成代码而缺乏严谨的工程控制。通过引入严格的反馈循环、领域建模和架构审查，这套技能集帮助开发者在享受 AI 效率的同时，保持对代码质量和系统设计的绝对掌控。

核心理念：回归软件工程基础

Matt Pocock 指出，许多现有的 AI 工作流（如 GSD、BMAD）试图通过僵化的流程来控制 AI，但这往往剥夺了开发者的控制权，且难以调试。他的技能集设计得小巧、可组合且易于调整，基于数十年的工程经验，专注于解决以下四大核心痛点：

1. 消除目标不一致：拷问会话 (/grill-me)

• 问题：AI 经常误解用户意图，导致构建出偏离需求的功能。
• 解决方案：在编码前进行“拷问会话”。/grill-me 和 /grill-with-docs 会迫使 AI 就需求细节向用户提出尖锐问题，直到双方达成完全一致。后者还能同步更新项目的 CONTEXT.md 和架构决策记录（ADR），建立共享的领域语言。

2. 建立共享语言：减少冗余与令牌消耗

• 问题：AI 使用冗长且不一致的术语，导致沟通低效且代码库难以导航。
• 解决方案：通过 /grill-with-docs 构建项目的领域模型。例如，将“当一个课程节内的某节课被设为‘真实’时存在一个问题”精炼为“物化级联存在问题”。这不仅让交流更简洁，还降低了 AI 思考时的 Token 消耗，并统一了变量和文件命名。

3. 强化反馈循环：TDD 与调试 (/tdd, /diagnosing-bugs)

• 问题：没有运行反馈的 AI 如同“盲飞”，容易生成看似正确但实际无法运行的代码。
• 解决方案：
  • /tdd：强制实施测试驱动开发（红-绿-重构循环），确保每个功能都有测试覆盖。
  • /diagnosing-bugs：提供结构化的调试循环（重现 → 最小化 → 假设 → 检测 → 修复 → 回归测试），避免盲目试错。

4. 对抗软件熵：架构审查 (/improve-codebase-architecture)

• 问题：AI 加速编码的同时也加速了代码库的腐化，导致“泥球”架构。
• 解决方案：定期运行 /improve-codebase-architecture，扫描代码库以识别深化模块的机会，并生成可视化 HTML 报告。这有助于在代码库变得不可维护之前进行重构。

技能清单概览

该仓库将技能分为用户调用（由开发者主动触发）和模型调用（由 AI 根据上下文自动触发或作为子程序调用）两类：

快速开始

1. 安装技能：

   npx skills@latest add mattpocock/skills
   

2. 初始化配置：
   在您的编码智能体（如 Claude Code, Codex 等）中运行：

   /setup-matt-pocock-skills
   

   该命令将引导您配置 Issue 跟踪器（GitHub/Linear/本地）、分类标签以及文档存储路径。