# Whetstone：为 Claude Code 注入工程纪律的插件化开发工具集

> Whetstone 是一个 Claude Code 插件，通过 30 个技能、19 个专业代理和 22 个命令，为 AI 编程助手注入工程纪律。本文深入解析其技能系统、工作流命令和多代理架构，探讨如何通过结构化流程提升 AI 辅助开发的质量和一致性。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-16T13:15:15.000Z
- 最近活动: 2026-05-16T13:23:12.116Z
- 热度: 150.9
- 关键词: Claude Code, AI编程, 工程纪律, 代码审查, 技能系统, 多代理, 工作流自动化, 开源插件
- 页面链接: https://www.zingnex.cn/forum/thread/whetstone-claude-code
- Canonical: https://www.zingnex.cn/forum/thread/whetstone-claude-code
- Markdown 来源: ingested_event

---

## 背景：AI 编程助手的能力与纪律鸿沟

当前的大型语言模型在代码生成方面展现出惊人的能力，但"能力"与"纪律"之间存在显著鸿沟。AI 编程助手常常跳过规划阶段、在未验证的情况下宣称"完成"、对症状进行修补而非找到根本原因，并在上下文重置后遗忘已学到的经验。

这种"无纪律的能力"导致了一个悖论：输出看起来很精致，但底层行为缺乏系统性。Whetstone 项目正是针对这一问题提出的解决方案——它不是增加模型的能力，而是为模型建立流程和纪律。

## 项目概览：什么是 Whetstone

Whetstone 是一个 Claude Code 插件，为 AI 编程助手提供工程纪律框架。它包含：

- **30 个技能（Skills）**：根据文件类型和任务信号自动激活的指令集
- **19 个专业代理（Agents）**：针对特定领域（如安全、性能、架构）的专用子代理
- **22 个命令（Commands）**：覆盖从头脑风暴到发布的完整开发工作流
- **1 个 MCP 服务器**：用于与其他工具集成

插件支持 PHP、Python、TypeScript、React 等多种技术栈，并提供向 Codex、OpenCode 等其他 AI 工具的转换能力。

## 核心理念：流程先于代码

Whetstone 的设计哲学可以概括为"流程先于代码"。它通过以下机制强制执行工程纪律：

### 编码前必须规划
通过 `/ia-brainstorm` 和 `/ia-plan` 命令，确保在编写代码之前充分探索需求、权衡方案并制定详细的实施计划。

### 宣称完成前必须验证
`/ia-verification-before-completion` 技能实施五步验证门：识别、运行、阅读、验证、宣称。禁止复用先前的结果，并将"首次通过零问题"视为危险信号。

### 修补前必须找到根本原因
`/ia-debugging` 技能强制执行"无修复直到找到根本原因"的铁律，要求提供文件:行号级别的证据，并在三次失败尝试后升级而非继续猜测。

### 合并前必须经过审查
`/ia-review` 命令实施多代理代码审查，检测范围漂移、规范合规性、代码质量、安全性和性能问题。

## 技能系统：上下文感知的指令集

Whetstone 的技能系统是其核心创新之一。与传统的手动切换模式不同，技能根据工作上下文自动激活。

### 技能设计原则

每个技能遵循严格的设计原则：

- **Token 效率**：控制在 1K token 以内，2K 为硬上限。溢出内容移至按需加载的 references/ 文件
- **前置关键信息**：将最重要的规则放在最前面，因为模型注意力会随文本长度衰减
- **行动导向**：告诉代理做什么，而非解释概念。跳过模型已经知道的内容
- **每个"不要"都有"取而代之"**：单纯的禁止会让代理猜测，提供替代方案给出明确路径
- **关键词丰富的描述**：描述是启动时唯一加载的部分，代理用它来决定是否激活技能

### 技术栈特定技能

Whetstone 提供了针对不同技术栈的深度技能：

**前端开发**：
- `ia-react-frontend`：将"是否应该使用 effect"的问题导向非 effect 解决方案，分离状态工具用途（Zustand 用于客户端、React Query 用于服务端、nuqs 用于 URL），强制执行 React 19 模式

**后端服务**：
- `ia-nodejs-backend`：严格分层架构（路由 > 服务 > 仓库），禁止跨层 HTTP 导入，使用 Zod schema 作为单一事实来源
- `ia-python-services`：强制使用现代工具（uv、ruff、ty），结构化并发通过 asyncio.TaskGroup，幂等后台作业
- `ia-php-laravel`：处处使用 `declare(strict_types=1)`，PHPStan level 8+，胖模型/瘦控制器
- `ia-rust-systems`：Edition 2024，工作区布局，thiserror/anyhow 区分，unsafe 块需 SAFETY 注释

**基础设施与运维**：
- `ia-postgresql`：使用 BIGINT GENERATED ALWAYS AS IDENTITY 而非 SERIAL，TIMESTAMPTZ 而非 TIMESTAMP，每个外键必须有索引
- `ia-terraform`：for_each 优于 count，远程状态带锁，moved 块用于重命名
- `ia-linux-bash-scripting`：`set -Eeuo pipefail` 为基础，EXIT trap 用于清理，printf 优于 echo

## 专业代理：领域专家的自动化

Whetstone 包含 19 个专业代理，每个代理在隔离环境中运行，拥有独立的工具和上下文：

### 质量与合规代理
- **ia-accessibility-tester**：WCAG 2.1 审计，涵盖键盘导航、屏幕阅读器兼容性、对比度、ARIA 属性
- **ia-architecture-strategist**：评估架构合理性、设计模式合规性和结构一致性
- **ia-cloud-architect**：基于 AWS/Azure/GCP 的 Well-Architected Framework 原则分析基础设施
- **ia-database-guardian**：验证迁移安全性、引用约束和数据完整性
- **ia-security-sentinel**：威胁建模和漏洞扫描，涵盖认证、输入验证、密钥管理
- **ia-performance-oracle**：识别算法复杂度、数据库查询、内存使用和可扩展性限制方面的瓶颈

### 研究与分析代理
- **ia-best-practices-researcher**：收集官方框架文档、版本特定最佳实践和行业标准
- **ia-git-history-analyzer**：挖掘 git 历史解释代码演进，追踪提交、作者和决策背景
- **ia-learnings-researcher**：从 docs/solutions/ 挖掘已记录的解决方案和模式
- **ia-repo-research-analyst**：分析仓库架构、命名约定和实现模式

### 设计与实现代理
- **ia-design-iterator**：通过截图-分析-改进循环进行迭代式 UI 优化
- **ia-figma-design-sync**：将实现的 UI 与 Figma 设计对比，报告差异
- **ia-bug-reproduction-validator**：复现 bug 报告并识别根本原因，不应用修复
- **ia-deployment-verification-agent**：为高风险变更生成 Go/No-Go 部署手册
- **ia-infrastructure-engineer**：完整的部署生命周期覆盖，包括 CI/CD、容器化、可观测性

## 工作流命令：从想法到发布的完整闭环

Whetstone 提供五个核心命令形成开发闭环：

### /ia-brainstorm：探索与澄清
通过逐个提问的方式访谈用户，揭示隐藏需求。产出 2-3 个命名方案及其权衡。在获得批准的设计文档之前不生成代码。

### /ia-plan：从想法到计划
将头脑风暴或功能想法转化为基于文件的实施计划，包含原子任务、具体文件路径和垂直切片的分阶段交付。

### /ia-work：执行与验证
执行计划，包含任务跟踪、工作树隔离和验证门。每个任务在标记完成前必须通过构建/测试。

### /ia-review：多代理代码审查
范围漂移检测、规范合规性、代码质量、安全性、性能。在复杂差异出现 3+ 复杂度信号时自动升级为深度模式。

### /ia-compound：知识沉淀
将刚解决的问题捕获为可搜索的文档，存储在 docs/solutions/ 中，使下一个人（或代理）不必重新调试。

## 技能蒸馏器：持续进化的技能库

Whetstone 包含一个独特的"技能蒸馏器（Skill Distillery）"系统，用于生成、评估和进化技能：

### 蒸馏流程
1. **搜索**：从社区获取高评分的技能源
2. **分析**：识别重叠建议，剥离填充内容，解决矛盾
3. **合成**：为每个主题生成一个聚焦的指令集
4. **评估**：通过 LLM-as-judge 评分技能有效性
5. **进化**：通过 DSPy 优化技能
6. **测试**：回归测试触发模式

通过挖掘 Claude Code 会话日志构建评估数据集，通过评估的技能被提升入主插件。

## 多平台支持

Whetstone 原生为 Claude Code 设计，但通过转换器支持其他平台：

- **Codex**：通过 Bun/TypeScript 转换器生成 Codex 原生输出
- **OpenCode**：翻译 SKILL.md 格式为 OpenCode 预期格式
- **通用技能**：`ai-skills` 仓库提供只读镜像，支持 Cursor、Gemini CLI、Copilot CLI 等 35+ 代理

## 使用场景与目标用户

Whetstone 特别适合以下场景：

**团队使用 Claude Code 进行实际开发**：无论使用 PHP、Python、TypeScript 还是 React，代理都会在编写代码前进行规划，在发布前进行验证，通过推理而非猜测进行调试。

**追求一致性的独立开发者**：编写 Bash 脚本时强制执行 `set -Eeuo pipefail` 和 ShellCheck 合规性，接触 Laravel 控制器时应用严格类型和瘦控制器模式。无需设置，无需切换。

**构建 AI 代理的开发者**：包含多代理编排、代理原生架构设计的技能，以及从顶级社区源生成新技能的蒸馏器。

## 局限性与注意事项

使用 Whetstone 时需要注意：

1. **上下文消耗**：技能会消耗上下文 token，每个技能使用的 token 都是代理无法用于代码的 token
2. **学习曲线**：完整的工作流需要理解和适应，初期可能感觉繁琐
3. **并非万能**：技能强制执行纪律，但不能替代深入的技术理解和团队沟通
4. **平台依赖**：虽然支持多平台转换，但原生体验仅在 Claude Code 上完全实现

## 结语

Whetstone 代表了一种重要的 AI 辅助开发范式：从追求"更聪明的模型"转向建立"更好的流程"。它承认当前 AI 模型的能力已经足够强大，真正缺乏的是系统性的工程纪律。

通过 30 个精心设计的技能、19 个专业代理和覆盖完整开发周期的 22 个命令，Whetstone 为 AI 编程助手提供了一个结构化框架。这不仅提升了单个任务的质量，更重要的是建立了可复用的知识库（通过 `/ia-compound`），使团队能够持续积累和学习。

对于希望将 AI 编程助手从"玩具"升级为"生产工具"的开发者和团队，Whetstone 提供了一个经过深思熟虑的实践路径。