从 superpowers 迁到 Matt

{
  "enabledPlugins": {
    "mattpocock-skills@claude-plugins-official": true,
    "superpowers@claude-plugins-official": false
  }
}

{
  "enabledPlugins": {
    "superpowers@claude-plugins-official": true,
    "mattpocock-skills@claude-plugins-official": false
  }
}

{
  "skillOverrides": {
    "tdd": "user-invocable-only",
    "diagnosing-bugs": "user-invocable-only"
  }
}

## 工作流程（硬规则）
- 实质改动（新功能、改行为、改数据结构）写代码之前，docs/specs/ 里必须有对应的 spec。没有就停下，请我运行 /mattpocock-skills:grill-with-docs 和 /mattpocock-skills:to-spec
- 有了 spec 再用 tdd skill 实现，一次一个切片
- 一行级的修复可以不写 spec，但提交信息里要写明原因
- 说"完成"之前，贴出全量测试、类型检查、lint 的命令和结果；UI 改动要真打开页面看过

#!/bin/bash
# 当前分支没有对应的 spec，就不许改 src/ 下的文件
input=$(cat)
file=$(jq -r '.tool_input.file_path // empty' <<<"$input")
[[ "$file" == */src/* ]] || exit 0                    # 只管业务代码

cd "$(jq -r '.cwd' <<<"$input")" 2>/dev/null || exit 0
root=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0
branch=$(git -C "$root" rev-parse --abbrev-ref HEAD)
[[ "$branch" == chore/* ]] && exit 0                   # 杂务分支豁免
slug=${branch#*/}                                      # feature/todo-tags → todo-tags
ls "$root"/docs/specs/*_"$slug".md >/dev/null 2>&1 && exit 0

echo "分支 $branch 没有对应的 docs/specs/*_$slug.md。先停下，请用户运行 /mattpocock-skills:grill-with-docs 和 /mattpocock-skills:to-spec；一行级修复请改用 chore/ 分支。" >&2
exit 2

#!/bin/bash
# 本次会话改过 src/，收工前必须过测试和类型检查
# 参数：start（SessionStart）、prompt（UserPromptSubmit）、stop（Stop）
input=$(cat)
sid=$(jq -r '.session_id' <<<"$input")
cd "$(jq -r '.cwd' <<<"$input")" 2>/dev/null || exit 0
cd "$(git rev-parse --show-toplevel 2>/dev/null)" || exit 0
state="$(git rev-parse --git-common-dir)/claude-verify"
mkdir -p "$state"

case "$1" in
  start)   # 记下会话开始时的 HEAD，只记第一次
    [[ -f "$state/$sid.base" ]] || git rev-parse HEAD > "$state/$sid.base" ;;
  prompt)  # 用户发"豁免验证：原因"，本会话不再拦，并记一笔
    prompt=$(jq -r '.prompt' <<<"$input")
    if [[ "$prompt" == 豁免验证* ]]; then
      echo "$(date +%F) $sid ${prompt%%$'\n'*}" >> "$state/waivers.log"
      touch "$state/$sid.waived"
    fi ;;
  stop)
    [[ -f "$state/$sid.waived" ]] && exit 0
    base=$(cat "$state/$sid.base" 2>/dev/null || echo HEAD)
    changed=$(git diff --name-only "$base" -- src; git ls-files --others --exclude-standard -- src)
    [[ -z "$changed" ]] && exit 0                      # 本次会话没动 src/（已提交的也算）
    out=$( { bun test && bunx tsc --noEmit; } 2>&1 ) && exit 0
    if [[ "$(jq -r '.stop_hook_active' <<<"$input")" == "true" ]]; then
      # 已经拦过一次仍没通过：放行，但把决定交给用户
      jq -n '{systemMessage: "本次会话改过 src/，测试或类型检查仍未通过。让 Claude 继续修，或者发一条以「豁免验证」开头、写明原因的消息。"}'
      exit 0
    fi
    { echo "本次会话改过 src/，但测试或类型检查没通过。先修好再结束；修不好就停下，向用户说明原因。"
      echo "$out" | tail -20; } >&2
    exit 2 ;;
esac
exit 0

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/require-spec.sh" }
        ]
      }
    ],
    "SessionStart": [
      {
        "hooks": [
          { "type": "command", "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/verify-gate.sh start" }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "hooks": [
          { "type": "command", "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/verify-gate.sh prompt" }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/verify-gate.sh stop" }
        ]
      }
    ]
  }
}

| 日期 | 任务 | 引擎 | 返工轮数 | 审查发现（高/中/低） | PR 合并周期 | 跳过流程 | 备注 |
|---|---|---|---|---|---|---|---|
| 2026-10-20 | 待办加标签 | Matt | 1 | 0/2/3 | 1.5 天 | 否 | grill 问出了标签数量上限 |
| 2026-10-22 | 修复筛选分页 | Matt | 2 | 1/1/0 | 0.5 天 | 是 | 没写 spec，被 hook 拦了一次 |

# 最近 50 个已合并 PR 的创建和合并时间，用来算 PR 合并周期
gh pr list --state merged --limit 50 --json number,title,createdAt,mergedAt

# 某份 spec 首次提交的日期，想从 spec 确认算起时用
git log --diff-filter=A --format=%ad --date=short -- docs/specs/2026-10-16_todo-tags.md

# 最近 100 个已合并 PR 里，有多少没链接 spec
gh pr list --state merged --limit 100 --json number,body \
  --jq '[.[] | select((.body // "") | contains("docs/specs/") | not)] | length'