塑形技能

用于塑形和面包板设计的 Claude Code 技能——源自 Shape Up 的方法论，并针对与大型语言模型协作进行了调整。

案例研究： 使用 Claude Code 进行 0-1 塑形 详细介绍了如何利用这些技能从零开始构建一个项目。该项目的源代码位于 rjs/tick。

技能

文档类技能——适用于协作工作

这些技能可以将真实的对话记录转化为结构化的塑形文档。它们在实际生产项目中非常有用，尤其是在与他人合作时，能够将讨论内容以可执行的格式记录下来。

这些技能极度依赖输入质量（GIGO，即“垃圾进，垃圾出”）。 它们不会评估输入内容是否有意义或合理性，只会进行格式化和提炼——仅此而已。当输入是高质量、富有逻辑的对话时，它们可以节省大量时间；但如果输入本身存在问题，最终得到的也只是一个格式精美的错误文档。

/framing-doc — 将对话记录转化为框架文档，明确需要解决的问题以及为何选择该问题而非其他替代方案。

/kickoff-doc — 将塑形后的项目启动会议记录转化为一份供开发人员参考的文档，记录下已确定的塑形结果和共识。

单人技能——更具实验性

这些技能直接用于与 Claude 进行塑形和设计工作。相比文档类技能，它们的实战经验较少，仍处于实验阶段。

/shaping — 在正式进入实现之前，对问题（需求）和解决方案（形态）进行迭代优化。它将“需要什么”与“如何实现”分开，并通过适配性检查来确认哪些部分已经解决，哪些尚未解决。

/breadboarding — 将系统映射为用户界面操作、代码功能接口以及系统间的连接方式。在一个视图中清晰展示用户可执行的操作及其底层实现逻辑，非常适合用于划分垂直功能范围。

安装

# 克隆仓库，然后将每项技能创建符号链接到你的 Claude Code 技能目录
git clone https://github.com/rjs/shaping-skills.git ~/.local/share/shaping-skills
ln -s ~/.local/share/shaping-skills/framing-doc ~/.claude/skills/framing-doc
ln -s ~/.local/share/shaping-skills/kickoff-doc ~/.claude/skills/kickoff-doc
ln -s ~/.local/share/shaping-skills/breadboarding ~/.claude/skills/breadboarding
ln -s ~/.local/share/shaping-skills/shaping ~/.claude/skills/shaping

每项技能必须位于 ~/.claude/skills/ 的直接子目录中，这样 Claude Code 才能识别并加载它们。通过符号链接的方式，你可以随时使用 git pull 来更新这些技能。

钩子：涟漪检查

该仓库包含一个钩子，可在编辑塑形文档时提醒 Claude 检查潜在的连锁影响。当 Claude 编写或编辑带有 shaping: true 前置元数据的 .md 文件时，钩子会触发一个检查清单——更新操作表、适配性检查、工作流等。

设置步骤

1. 创建钩子脚本的符号链接：

mkdir -p ~/.claude/hooks
ln -s ~/.local/share/shaping-skills/hooks/shaping-ripple.sh ~/.claude/hooks/shaping-ripple.sh

2. 将钩子添加到你的 ~/.claude/settings.json 中：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/shaping-ripple.sh",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

此钩子会在每次调用 Write 或 Edit 工具后触发。它仅对塑形文档（即带有 shaping: true 前置元数据的文件）生效，其他文件则会直接跳过，不会有任何提示。

---

本 README 由 Claude Code 编写。

Shaping Skills 快速上手指南

Shaping Skills 是一套专为 Claude Code 设计的技能集，旨在将 Basecamp 的《Shape Up》方法论适配于大语言模型协作。它帮助开发者在编码前进行需求梳理（Shaping）和原型设计（Breadboarding），将对话转化为可执行的结构化文档。

环境准备

在使用本工具前，请确保满足以下条件：

• 操作系统：Linux 或 macOS（Windows 用户建议使用 WSL2）。
• 核心依赖：已安装并配置好 Claude Code 命令行工具。
• 版本控制：已安装 git。
• 目录结构：确保本地存在 ~/.claude/skills/ 和 ~/.claude/hooks/ 目录（通常由 Claude Code 初始化时自动创建）。

注意：目前该工具主要依托 GitHub 源，国内用户若克隆速度较慢，可自行配置 Git 加速代理或使用镜像站克隆。

安装步骤

1. 克隆仓库

将工具源码克隆到本地指定目录：

git clone https://github.com/rjs/shaping-skills.git ~/.local/share/shaping-skills

2. 创建技能软链接

将四个核心技能文件链接到 Claude Code 的技能目录中，以便自动识别：

ln -s ~/.local/share/shaping-skills/framing-doc ~/.claude/skills/framing-doc
ln -s ~/.local/share/shaping-skills/kickoff-doc ~/.claude/skills/kickoff-doc
ln -s ~/.local/share/shaping-skills/breadboarding ~/.claude/skills/breadboarding
ln -s ~/.local/share/shaping-skills/shaping ~/.claude/skills/shaping

3. （可选）安装涟漪检查钩子 (Ripple Check Hook)

此钩子会在修改标记为 shaping: true 的文档时，自动提醒检查关联影响（如功能表、适配性检查等）。

链接钩子脚本：

mkdir -p ~/.claude/hooks
ln -s ~/.local/share/shaping-skills/hooks/shaping-ripple.sh ~/.claude/hooks/shaping-ripple.sh

配置 settings.json： 编辑 ~/.claude/settings.json，添加以下配置以启用钩子：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/shaping-ripple.sh",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

基本使用

安装完成后，重启终端或在 Claude Code 会话中即可调用以下技能。

场景一：整理会议记录（协作文档类）

当你有一段关于项目讨论的转录文本，需要将其转化为结构化文档时：

• 生成立项框架文档 (/framing-doc) 用于提炼核心问题及选择该方案的原因。

  用法：在对话中粘贴会议记录，然后输入 /framing-doc。

• 生成项目启动文档 (/kickoff-doc) 用于将已确定的方案转化为开发者的参考文档。

  用法：在对话中提供定稿的讨论内容，然后输入 /kickoff-doc。

场景二：独立设计与原型（实验类）

当你独自使用 Claude 进行需求迭代或系统设计时：

• 需求与方案迭代 (/shaping) 在编码前分离“需要什么”和“如何构建”，并进行适配性检查。

  用法：描述你的初步想法，输入 /shaping 开始迭代循环。

• 系统原型映射 (/breadboarding) 将系统映射为 UI 交互、代码能力和连接逻辑，适合划分垂直切片范围。

  用法：输入 /breadboarding 并描述系统模块，生成全景视图。

使用提示

• 垃圾进，垃圾出 (GIGO)：文档类技能仅负责格式化和提炼，不会判断内容的合理性。请确保输入的对话内容质量较高。
• 钩子触发：若启用了 Ripple Check，仅在 Markdown 文件头包含 shaping: true 时才会触发检查列表。