harveyz-skill 0.2.1 → 0.3.0

package/README.md

@@ -4,12 +4,73 @@ Harvey 的个人 Claude Code 技能仓库。
 
 ## 技能清单
 
-| 技能 | 说明 | 外部依赖 |
-|------|------|---------|
-| **harvey-plain** | 白话引擎 — 把任何内容改写到聪明的十二岁小孩也能懂 | 无 |
-| **skill-analyzer** | 系统化分析 Skill 仓库的框架，基于洋葱模型四层结构 | 无 |
+按 bundle 分组，`npx harveyz-skill --bundle <bundle>` 安装对应分组。
+
+### analysis — 分析工具
+
+| 技能 | 说明 |
+|------|------|
+| **skill-analyzer** | 系统化分析 Skill 仓库的框架，基于洋葱模型四层结构 |
+
+### brainstorming — 设计与规划工具
+
+| 技能 | 说明 |
+|------|------|
+| **brainstorming** | 设计前强制探索阶段 — 在实现任何功能前，先理解意图、需求和设计方案（HARD-GATE） |
+| **writing-plans** | 将设计拆解为可执行的小任务（2–5 分钟/任务），含精确文件路径和验证步骤 |
+
+### dev — 开发工作流
+
+| 技能 | 说明 |
+|------|------|
+| **git-workflow-init** | 初始化或更新 git 分支管理规范，差量部署 git hooks，生成工作流文档 |
+| **executing-plans** | 执行书面实施计划，含两阶段 review（规格合规性 → 代码质量） |
+| **systematic-debugging** | 系统化 debug — 必须先找到根本原因，再提修复方案 |
+| **using-git-worktrees** | 创建隔离 worktree 进行特性开发，验证干净的测试基线后再开始 |
+
+### document — 文档工具
+
+| 技能 | 说明 |
+|------|------|
+| **diataxis-docs** | 管理 `docs/` 目录 — 遵循 Diátaxis 方法论，写新文档、更新或删除时触发 |
+
+### harness — 测试工具
+
+| 技能 | 说明 |
+|------|------|
+| **full-stack-debug-env** | 多组件应用全栈日志监控环境搭建 — 为前端、后端、worker 等各层建立独立日志文件 |
+
+### task — 任务管理
+
+| 技能 | 说明 |
+|------|------|
+| **pm-task-dispatch** | PM 任务派发 — 需求澄清 → 分析细化 → 创建任务文档 → 派发给 Agent → 追踪反馈 |
+| **task-close** | 任务收尾 — Agent 完成任务后执行验收、总结、文档归档和问题记录 |
+
+### web-fetch — 网页抓取
+
+| 技能 | 说明 |
+|------|------|
+| **article-fetcher** | 抓取 URL → 翻译为中文 → 存入 Obsidian；支持 X.com / Twitter（Playwright + Chrome Profile） |
+
+### writing — 写作工具
+
+| 技能 | 说明 |
+|------|------|
+| **mermaid-diagram** | Mermaid 专业作图 — 图类型选择、Roland Berger 配色、语法禁区、渲染前 12 项检查清单 |
+
+---
+
+## 工具清单
+
+Shell 工具，通过 `npx harveyz-skill --bundle shell-tools` 安装。
+
+| 工具 | 说明 |
+|------|------|
+| **p-launch** | 交互式项目启动器 — 从多个目录中快速选择并跳转到项目 |
+
+---
 
-> 更多技能陆续添加中。
 
 ## 安装
 
@@ -32,25 +93,37 @@ npx harveyz-skill --bundle brainstorming,dev --target all
 npx harveyz-skill list
 ```
 
-### 手动安装（从源码）
+### 本地源码安装
+
+克隆仓库后，用 CLI 安装：
 
 ```bash
-mkdir -p ~/.claude/skills
-cp -r skills/* ~/.claude/skills/
-```
+# 交互式选择 bundle 和目标工具
+node bin/cli.js
 
-## 工作流
+# 安装指定 skill
+node bin/cli.js --skill mermaid-diagram --target claude
+node bin/cli.js --skill brainstorming,writing-plans --target claude
 
-```
-harvey-plain: 内容 → org-mode 文件（~/Documents/notes/）
+# 安装整个 skill bundle
+node bin/cli.js --bundle dev --target claude
+
+# 安装指定 shell 工具（固定安装到 ~/.local/bin）
+node bin/cli.js --tool p-launch
+
+# 覆盖已有安装
+node bin/cli.js --skill mermaid-diagram --target claude --force
+node bin/cli.js --tool p-launch --force
 ```
 
+Skills 安装到 `~/.claude/skills/`，shell 工具安装到 `~/.local/bin/`。
+
 ## Skill 开发指南
 
 ### 命名规范
 
-- 前缀：`harvey-`（例：`harvey-plain`、`harvey-card`）
-- 每个 skill 独立目录，`SKILL.md` 是唯一入口
+- Flat skill：直接放 `skills/<category>/<skill-name>/SKILL.md`
+- Skill group：`skills/<group>/` 下多个子目录，每个含 `SKILL.md`
 
 ### SKILL.md 格式
 
@@ -63,7 +136,13 @@ version: "x.x.x"
 ---
 ```
 
-### 共享规范
+### 发布流程
+
+1. 在 `skills/<category>/<skill-name>/` 下创建 `SKILL.md`
+2. 在 `skills-index.json` 的 `skills[]` 中添加条目，指定 `path` 和 `bundle`
+3. 运行 `node scripts/generate-npmignore.js`（`prepack` 钩子会自动执行）
+
+### 共享输出规范
 
 **Org-mode 输出：**
 - 加粗：`*text*`（单星号）

package/bin/cli.js

@@ -3,7 +3,7 @@ import { checkbox } from '@inquirer/prompts'
 import chalk from 'chalk'
 import {
   buildAllChoices, getAllSkillItems, getAllToolItems,
-  resolveSkills, resolveTools,
+  resolveSkills, resolveSkillsByName, resolveTools, resolveToolsByName,
   TOOL_BUNDLE_CHOICES,
 } from '../lib/bundles.js'
 import { TARGET_CHOICES, resolveTargets, TARGETS } from '../lib/targets.js'
@@ -13,8 +13,12 @@ const args = process.argv.slice(2)
 const forceFlag = args.includes('--force')
 const bundleIdx = args.indexOf('--bundle')
 const targetIdx = args.indexOf('--target')
+const toolIdx   = args.indexOf('--tool')
+const skillIdx  = args.indexOf('--skill')
 const bundleArg = bundleIdx !== -1 ? args[bundleIdx + 1] : undefined
 const targetArg = targetIdx !== -1 ? args[targetIdx + 1] : undefined
+const toolArg   = toolIdx   !== -1 ? args[toolIdx   + 1] : undefined
+const skillArg  = skillIdx  !== -1 ? args[skillIdx  + 1] : undefined
 
 if (args[0] === 'list') {
   const { createRequire } = await import('module')
@@ -58,7 +62,13 @@ try {
   let skillItems = []
   let toolItems  = []
 
-  if (bundleArg) {
+  if (toolArg) {
+    const names = toolArg.split(',').map(s => s.trim()).filter(Boolean)
+    toolItems = resolveToolsByName(names).map(t => ({ kind: 'tool', ...t }))
+  } else if (skillArg) {
+    const names = skillArg.split(',').map(s => s.trim()).filter(Boolean)
+    skillItems = resolveSkillsByName(names).map(s => ({ kind: 'skill', ...s }))
+  } else if (bundleArg) {
     const bundles = bundleArg.split(',').map(s => s.trim()).filter(Boolean)
     const skillBundles = bundles.filter(b => !TOOL_BUNDLE_VALUES.has(b))
     const toolBundles  = bundles.filter(b =>  TOOL_BUNDLE_VALUES.has(b))

package/lib/bundles.js

@@ -26,6 +26,14 @@ export const BUNDLE_CHOICES = [
   { name: `${'all'.padEnd(16)} — 全部 skill`, value: 'all' },
 ]
 
+export function resolveSkillsByName(names) {
+  return names.map(name => {
+    const skill = skillDefs.find(s => s.path.split('/').pop() === name)
+    if (!skill) throw new Error(`Unknown skill: "${name}"`)
+    return { skillName: name, srcPath: path.join(skillsRoot, skill.path) }
+  })
+}
+
 export function resolveSkills(selectedBundles) {
   const expanded = selectedBundles.includes('all') ? namedBundles : selectedBundles
 
@@ -96,6 +104,14 @@ export const TOOL_BUNDLE_CHOICES = namedToolBundles.map(name => ({
   value: name,
 }))
 
+export function resolveToolsByName(names) {
+  return names.map(name => {
+    const tool = toolDefs.find(t => t.name === name)
+    if (!tool) throw new Error(`Unknown tool: "${name}"`)
+    return { toolName: tool.name, srcPath: path.join(repoRoot, 'tools', tool.name) }
+  })
+}
+
 export function resolveTools(selectedBundles) {
   const expanded = selectedBundles.includes('all') ? namedToolBundles : selectedBundles
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "One-click skill installer for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -19,6 +19,7 @@
     "skills/harness/diataxis-docs/",
     "skills/harness/full-stack-debug-env/",
     "skills/superpowers-fork/brainstorming/",
+    "skills/harness/git-workflow-init/",
     "skills/superpowers-fork/executing-plans/",
     "skills/superpowers-fork/systematic-debugging/",
     "skills/superpowers-fork/using-git-worktrees/",

package/skills/harness/git-workflow-init/SKILL.md

@@ -0,0 +1,321 @@
+---
+name: git-workflow-init
+description: 初始化或更新 git 分支管理规范：读取项目的 workflow-config.yml，审核配置，差量生成并部署 git hooks（pre-commit、commit-msg、pre-push、post-checkout），生成工作流文档，可选写入 AI 配置文件引用。支持差量更新、MANAGED 块 hash 校验（检测用户手改）、lock 文件 diff（检测配置变更）、conflict scanner（检测用户代码与新配置的交叉冲突）。触发时机：初始化新 git 仓库、新项目首次配置 git、用户要求设置/更新分支保护或分支规范、安装或重新部署 git hooks、skill 或模板更新后需要同步、或问到分支命名规范。只要项目需要配置或更新 git 工作流，就应使用此 skill。
+user_invocable: true
+version: "4.0.0"
+---
+
+# Git 工作流初始化
+
+读取 `workflow-config.yml`，审核配置，差量部署 git hooks。
+重新运行时自动检测配置变更、用户手改冲突、用户代码与新规则的交叉冲突，一次性汇总让用户决策后再写入。
+
+---
+
+## 执行步骤
+
+### Step 1 — 确认 git 仓库
+
+```bash
+git rev-parse --show-toplevel
+```
+
+若不在 git 仓库中，询问用户是否先执行 `git init`，用户拒绝则优雅停止。
+
+---
+
+### Step 2 — 读取配置
+
+按以下顺序查找 `workflow-config.yml`：
+
+1. 项目根目录 `workflow-config.yml`
+2. 项目根目录 `.claude/workflow-config.yml`
+
+若两处均不存在，询问用户：
+- 使用默认配置（从此 skill 的 `references/workflow-config.yml` 复制到项目根目录）
+- 还是中止并自行创建后重新运行
+
+找到后读取并解析 YAML。
+
+---
+
+### Step 3 — 审核配置
+
+对配置内容逐项检查，**发现所有问题后一次性报告，不逐条中止**。
+
+**结构校验：**
+- `meta.preset` 若存在，必须是 `gitflow`、`github-flow`、`trunk-based`、`custom` 之一
+- `commit_message.format` 必须是 `conventional`、`regex`、`none` 之一
+- 若 `format: regex`，必须同时存在 `pattern` 字段
+
+**逻辑校验：**
+- `branches.protected` 中任何分支的 `merge_from` 不得包含自身（循环依赖）
+- `push_rules.block_force_push` 中的分支建议与 `branches.protected` 保持一致，不一致则警告
+- `branch_naming.exempt` 中的分支不应同时被 `allowed_patterns` 覆盖（冗余）
+
+**正则校验：**（对每个 pattern 执行，返回 2 = 非法）
+```bash
+echo "" | grep -E "<pattern>" > /dev/null 2>&1; echo $?
+```
+
+审核通过打印 `✅ 配置审核通过`，审核失败列出所有问题并停止。
+
+---
+
+### Step 4 — 分析当前状态（仅当 `.githooks/` 已存在时）
+
+**首次安装时跳过此步骤，直接进入 Step 5。**
+
+此步骤目标：在写入任何文件之前，全面了解当前状态，收集所有需要用户决策的冲突，在 Step 5 一次性呈现。
+
+#### 4a. Lock 文件 diff — 配置发生了什么变化
+
+读取 `.githooks/.workflow-config.lock.yml`（若不存在则视为全量新增，跳过 diff）。
+
+将 lock 文件中记录的上一次配置与当前配置对比，生成变更摘要：
+
+```
+配置变更摘要：
++ branches.protected 新增: develop（merge_from: feature/*）
+~ commit_message.conventional.types 修改: 新增 wip，移除 perf
+- tags.allowed_patterns 删除: ^v[0-9]+\.[0-9]+\.[0-9]+-rc\.[0-9]+$
+```
+
+**YAML 分支名提取规则（重要）：**
+
+不要用宽泛的 `grep "name:"` 提取分支名——YAML 多个层级都可能含有 `name:` 字段，会导致误匹配。用 `python3` 精确解析，进入 `protected:` 块后再匹配 `- name:`，遇到非缩进行则停止：
+
+```bash
+# FILE 传入要解析的文件路径（workflow-config.yml 或 lock 文件均适用）
+python3 -c "
+import re, sys
+content = open(sys.argv[1]).read()
+in_protected = False
+for line in content.splitlines():
+    if 'protected:' in line:
+        in_protected = True; continue
+    if in_protected:
+        m = re.match(r'\s+- name:\s+(\S+)', line)
+        if m: print(m.group(1))
+        elif line.strip() and not line.startswith(' '): break
+" "$FILE"
+```
+
+这份摘要用于后续冲突检测的输入。
+
+#### 4b. MANAGED 块 hash 校验 — 用户是否手改了生成的代码
+
+读取每个 hook 文件，提取所有 `BEGIN MANAGED` / `END MANAGED` 块。
+
+MANAGED 块格式：
+```sh
+# --- BEGIN MANAGED: <block-id> (hash:<8位hex>) ---
+<generated content>
+# --- END MANAGED: <block-id> ---
+```
+
+对每个块：重新计算块内容（两行标记之间的部分，去首尾空白）的 hash：
+```bash
+actual_hash=$(printf '%s' "<block_content>" | git hash-object --stdin | cut -c1-8)
+```
+
+若 `actual_hash` 与标记里记录的 hash 不一致 → 用户手改了此块，记录为冲突：
+
+```
+[手改冲突] .githooks/pre-commit 的 MANAGED 块 branches.protected/main 被手动修改
+  原始生成内容 hash: a3f9c2b1
+  当前内容 hash:     d7e42f0c
+  差异：（展示 diff）
+```
+
+#### 4c. 外部代码扫描 — 用户在 MANAGED 块外添加了什么
+
+提取每个 hook 文件中 MANAGED 块之外的所有代码（即用户手写区）。
+
+从用户代码中提取可解析的引用：
+
+| 提取目标 | 扫描方式 |
+|---------|---------|
+| 分支名 | `"$BRANCH" = "name"`、`case "name"`、`branch = "name"` |
+| 提交类型 | `grep -qE "...(type\|...)"`、字符串字面量 `wip`、`hotfix` |
+| Tag/分支 pattern | `grep -qE "pattern"` |
+| 外部脚本调用 | `./`、`bash `、`sh `、`npm run`、`make ` 开头的行 |
+
+#### 4d. 冲突检测 — 用户代码 × 新配置的交叉分析
+
+综合 4a（配置变更）、4b（手改块）、4c（用户代码）的结果，识别以下冲突类型：
+
+**冲突类型 A：用户代码覆盖了与新配置相同的条件**
+- 用户代码处理了分支 X，新配置也将 X 加入 `branches.protected`
+- 两段代码同时执行，可能产生矛盾行为
+
+**冲突类型 B：用户代码引用了配置中已删除的内容**
+- 用户代码里有对类型 `wip` 的处理，新配置删除了 `wip`
+- 用户代码逻辑失去对应的配置支撑
+
+**冲突类型 C：MANAGED 块被手动修改**
+- 来自 4b 的结果
+- 重新生成会覆盖用户修改
+
+**冲突类型 D：用户代码引用了新配置新增的内容（信息提示，非阻断）**
+- 用户已手写了对 `develop` 的处理，新配置也打算生成同名 MANAGED 块
+- 不一定冲突，但值得用户确认
+
+---
+
+### Step 5 — 冲突解决（一次性汇总，用户逐条决策）
+
+将 Step 4 发现的所有冲突汇总后**一次性呈现**，每条冲突附带建议选项。
+
+示例输出：
+
+```
+发现 3 处需要决策的冲突，请逐条确认：
+
+─────────────────────────────────────────────────────────
+[1/3] 手改冲突（类型 C）
+文件: .githooks/pre-commit，块: branches.protected/main
+用户对生成代码做了如下修改：
+  - echo "❌ 禁止直接在 main 上提交。"
+  + echo "❌ [POLICY] 禁止直接在 main 上提交，违规请联系 @team-lead。"
+选项：
+  A) 保留用户修改（此块不重新生成）
+  B) 用新配置覆盖（丢弃用户修改）
+─────────────────────────────────────────────────────────
+[2/3] 条件重叠（类型 A）
+文件: .githooks/pre-commit，用户代码第 58 行
+用户手写了 develop 分支的保护逻辑
+新配置将 develop 加入 branches.protected，也会生成对应 MANAGED 块
+选项：
+  A) 保留用户代码，跳过生成 develop 的 MANAGED 块
+  B) 用新配置生成 MANAGED 块，删除用户手写的重复代码
+  C) 两者都保留（会重复执行，请确认逻辑不矛盾）
+─────────────────────────────────────────────────────────
+[3/3] 引用断裂（类型 B）
+文件: .githooks/commit-msg，用户代码第 34 行
+用户代码引用了 commit 类型 wip，但新配置已从类型列表中移除 wip
+选项：
+  A) 保留用户代码（wip 检查逻辑继续生效，但配置层不再管理）
+  B) 删除用户代码中对 wip 的引用
+─────────────────────────────────────────────────────────
+```
+
+用户全部决策完成后，带着决策结果进入 Step 6。
+若无任何冲突，直接进入 Step 6。
+
+---
+
+### Step 6 — 差量生成并部署 hooks
+
+```bash
+mkdir -p .githooks
+```
+
+#### 生成原则
+
+根据 Step 5 的决策结果，对每个 hook 文件按以下规则处理：
+
+1. **MANAGED 块**：根据当前配置重新生成内容，更新块内容及 hash
+   - 若 Step 5 中用户选择"保留用户修改"→ 跳过此块，保持现有内容和 hash 不变
+   - 若配置中某节 `enforce: false` 且对应 MANAGED 块存在 → 删除该块（保留块外用户代码）
+
+2. **用户代码区（MANAGED 块外）**：永远不覆盖，原样保留
+
+3. **差量写入**：生成全文后与磁盘文件对比——内容相同标记 `UNCHANGED`，不同标记 `UPDATED`，新建标记 `NEW`
+
+各 hook 的触发条件、固定头部代码、MANAGED 块结构、块 ID 规范、hash 计算方式及多行内容写入技巧，见 `references/hook-templates.md`。
+
+#### 设置权限和 hooksPath
+
+```bash
+chmod +x .githooks/*
+git config core.hooksPath .githooks
+git config merge.ff false
+```
+
+`merge.ff false` 禁止 fast-forward 合并，确保每次合并都产生 merge commit，pre-commit 钩子才能检查合并来源分支。
+
+---
+
+### Step 7 — 从配置渲染并写入工作流文档（差量）
+
+每次运行都根据当前 `workflow-config.yml` 的最终状态重新渲染文档，确保文档与配置始终一致。
+
+#### 7a. 渲染文档
+
+```bash
+python3 <skill-path>/references/render_docs.py \
+  workflow-config.yml \
+  <skill-path>/references/git-workflow-template.md \
+  docs/reference/git-workflow.md
+# 输出 NEW / UPDATED / UNCHANGED
+```
+
+脚本自动处理所有占位符（`{{BRANCH_TOPOLOGY_ASCII}}`、`{{BRANCH_TABLE}}`、`{{PROTECTION_RULES}}`、`{{NAMING_TABLE}}`、`{{COMMIT_FORMAT_SECTION}}`、`{{NAMING_EXEMPT}}`、`{{FAQ_SECTION}}` 等）——无需逐一处理，渲染逻辑详见 `references/render_docs.py`。
+
+#### 7b. 差量写入
+
+1. 若 `docs/reference/` 不存在则创建
+2. 将渲染后的内容与现有 `docs/reference/git-workflow.md` 对比
+   - 内容相同 → 跳过，标记 `UNCHANGED`
+   - 内容不同或文件不存在 → 写入，标记 `UPDATED` 或 `NEW`
+3. 若 `docs/INDEX.md` 存在，追加索引行（已存在则跳过）
+
+---
+
+### Step 8 — 更新 AI 配置文件（可选）
+
+若文件中已包含 `docs/reference/git-workflow.md` 链接，跳过。
+
+否则询问用户是否在已存在的 `CLAUDE.md`、`AGENTS.md`、`GEMINI.md` 中追加：
+
+```markdown
+## Git 工作流
+
+分支命名规范、保护规则与合并流程详见 [docs/reference/git-workflow.md](docs/reference/git-workflow.md)。
+```
+
+---
+
+### Step 9 — 更新 lock 文件并汇报
+
+#### 更新 lock 文件
+
+将本次生效配置的关键字段写入 `.githooks/.workflow-config.lock.yml`，格式见 `references/lock-file-format.md`。
+
+#### 汇报结果
+
+用表格展示每个操作的状态：
+
+```
+文件                                状态
+─────────────────────────────────────────────────────
+workflow-config.yml                已读取
+.githooks/.workflow-config.lock    UPDATED（记录新配置快照）
+.githooks/pre-commit               UPDATED（main 块 hash 更新；develop 块新增）
+.githooks/commit-msg               UNCHANGED
+.githooks/pre-push                 UNCHANGED
+.githooks/post-checkout            NEW
+core.hooksPath                     = .githooks
+docs/reference/git-workflow.md     UPDATED
+CLAUDE.md                          已有引用，跳过
+─────────────────────────────────────────────────────
+冲突决策摘要：
+  [1/3] branches.protected/main 手改块 → 用户选择保留修改
+  [2/3] develop 分支条件重叠 → 用户选择使用新配置
+  [3/3] wip 类型引用断裂 → 用户选择保留用户代码
+```
+
+若有保留的无法映射规则，附注提示。
+
+---
+
+## 参考文件
+
+| 文件 | 说明 | 读取时机 |
+|------|------|---------|
+| `references/workflow-config.yml` | 配置文件模板 | Step 2：用户无配置时复制 |
+| `references/hook-templates.md` | 4 个 hook 的代码模板、块 ID 规范、hash 计算、多行写入技巧 | Step 6：生成 hooks 前 |
+| `references/lock-file-format.md` | lock 文件 YAML 格式 | Step 9：写入 lock 文件前 |
+| `references/git-workflow-template.md` | 工作流文档模板（含占位符） | Step 7：由 render_docs.py 读取 |
+| `references/render_docs.py` | 文档渲染脚本 | Step 7：直接执行 |

package/skills/harness/git-workflow-init/evals/evals.json

@@ -0,0 +1,104 @@
+{
+  "skill_name": "git-workflow-init",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "我刚在 /tmp/gwi-test-basic 创建了一个新的 Python 项目目录，已经 git init 了。目录里有一个 workflow-config.yml，内容是默认的 gitflow 配置（branches.protected 包含 main 和 staging，commit_message.enforce: true，tags.enforce: true，push_rules.enforce: true）。请帮我完整运行 git 工作流初始化，不需要更新 AI 配置文件。",
+      "expected_output": "skill 读取 workflow-config.yml，审核通过，在 /tmp/gwi-test-basic 中生成 .githooks/pre-commit、.githooks/commit-msg、.githooks/pre-push，设置 core.hooksPath，并生成 docs/reference/git-workflow.md",
+      "files": [],
+      "expectations": [
+        "skill 读取了项目根目录的 workflow-config.yml",
+        "审核步骤执行且通过，打印审核通过信息",
+        "pre-commit hook 内容包含对 main 和 staging 的保护逻辑，且基于配置动态生成",
+        "commit-msg hook 内容包含 Conventional Commits 检查和 max_subject_length 检查",
+        "pre-push hook 内容包含 tag 命名校验（refs/tags/* 分支）和 force push 阻断（refs/heads/* 分支）",
+        "所有 hook 安装在 .githooks/ 目录，core.hooksPath 已设置为 .githooks",
+        "docs/reference/git-workflow.md 已创建且内容反映配置中的实际规则"
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "我的项目在 /tmp/gwi-test-custom，已 git init，根目录有 workflow-config.yml，其中 branch_naming.enforce: true，commit_message.format: regex，commit_message.pattern: '^(JIRA-\\d+|NOJIRA): .{1,80}'，tags.enforce: false，push_rules.enforce: false。请运行 git 工作流初始化。",
+      "expected_output": "skill 安装 pre-commit、commit-msg、post-checkout hook，不安装 pre-push hook；commit-msg hook 使用自定义 regex 而非 Conventional Commits",
+      "files": [],
+      "expectations": [
+        "commit-msg hook 使用配置中的 pattern 字段进行校验，不使用 Conventional Commits 类型列表",
+        "post-checkout hook 已安装，包含分支命名检查逻辑",
+        "pre-push hook 未创建（tags.enforce 和 push_rules.enforce 均为 false）",
+        "core.hooksPath 已设置为 .githooks"
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "我的项目在 /tmp/gwi-test-claudemd，已 git init，目录里有默认 workflow-config.yml 和一个内容为 '# My Project\\n\\n这是一个 Node.js 项目。' 的 CLAUDE.md。请完整运行初始化并在 CLAUDE.md 中追加对 git 文档的索引引用。",
+      "expected_output": "hooks 已安装，docs/reference/git-workflow.md 已创建，CLAUDE.md 末尾追加了 Git Workflow 引用段落（只是索引链接，非完整内容）",
+      "files": [],
+      "expectations": [
+        "所有 hooks 已安装在 .githooks/ 目录",
+        "core.hooksPath 已设置为 .githooks",
+        "docs/reference/git-workflow.md 已创建",
+        "CLAUDE.md 中追加了对 docs/reference/git-workflow.md 的链接引用",
+        "CLAUDE.md 的引用只是索引链接，没有把完整 git 规范内容写进去"
+      ]
+    },
+    {
+      "id": 4,
+      "prompt": "帮我配置 git 分支管理规范。我当前目录是 /tmp/gwi-test-nogit（目录存在但没有 git init 过）。",
+      "expected_output": "skill 检测到不在 git 仓库中，向用户说明情况并询问是否先执行 git init，而不是直接报错退出或静默跳过",
+      "files": [],
+      "expectations": [
+        "skill 执行了 git rev-parse --show-toplevel 或等效命令来检测 git 仓库",
+        "skill 检测到非 git 仓库后，没有静默跳过，也没有直接崩溃报错",
+        "skill 向用户询问是否先执行 git init（而不是自动执行）",
+        "用户拒绝后 skill 优雅停止，没有留下半完成的状态"
+      ]
+    },
+    {
+      "id": 5,
+      "prompt": "我的项目在 /tmp/gwi-test-badconfig，已 git init，根目录有一个 workflow-config.yml，内容存在以下问题：1) main 的 merge_from 包含 'main' 自身；2) branch_naming.allowed_patterns 里有一个非法正则 '[unclosed'；3) commit_message.format 设为 'regex' 但没有 pattern 字段。请运行初始化。",
+      "expected_output": "skill 在审核阶段发现三个问题并一次性列出，停止执行，不部署任何 hook 文件",
+      "files": [],
+      "expectations": [
+        "skill 执行了配置审核步骤",
+        "审核报告一次性列出所有三个问题：循环依赖、非法正则、缺少 pattern 字段",
+        "审核失败后 skill 停止，没有创建任何 .githooks/ 文件",
+        "skill 提示用户修复配置后重新运行"
+      ]
+    },
+    {
+      "id": 6,
+      "prompt": "帮我配置 git 分支管理规范。我的项目在 /tmp/gwi-test-noconfig，已 git init，但目录里没有 workflow-config.yml。",
+      "expected_output": "skill 提示找不到配置文件，询问用户是否使用默认配置（从 references/workflow-config.yml 复制），用户同意后继续执行完整流程",
+      "files": [],
+      "expectations": [
+        "skill 检测到项目根目录和 .claude/ 目录均无 workflow-config.yml",
+        "skill 询问用户是否使用默认配置，未自动复制",
+        "用户同意后，skill 将 references/workflow-config.yml 复制到项目根目录",
+        "随后继续完整的审核和部署流程"
+      ]
+    }
+  ],
+  "v4_evals": [
+    {
+      "id": 7,
+      "name": "hash-check",
+      "prompt": "这个项目的 git hooks 已经安装过（有 MANAGED 块和 hash 标记），但我手动修改了 pre-commit 里 main 分支 MANAGED 块的错误提示文字，没有更新 hash。现在重新运行 git-workflow-init，处理这个变更。",
+      "expected_output": "skill 重算 MANAGED 块 hash，发现与标记不符，报告 type C 冲突（手改冲突），展示 diff，询问用户保留修改还是用新配置覆盖，按用户决策处理。",
+      "assertions": []
+    },
+    {
+      "id": 8,
+      "name": "lock-diff-add-branch",
+      "prompt": "我在 workflow-config.yml 里新增了 develop 分支保护规则（merge_from: feature/*）。上次安装时的 lock 文件里没有 develop。现在重新运行 git-workflow-init，同步变更。",
+      "expected_output": "skill 对比 lock 文件与当前配置，检测到 develop 是新增分支，在 pre-commit 插入对应 MANAGED 块，更新 lock 文件，报告 pre-commit 状态为 UPDATED。",
+      "assertions": []
+    },
+    {
+      "id": 9,
+      "name": "conflict-scanner",
+      "prompt": "我在 pre-commit 的 MANAGED 块外手写了 develop 分支的保护逻辑。现在 workflow-config.yml 也把 develop 加入了 branches.protected。重新运行 git-workflow-init。",
+      "expected_output": "skill 扫描 MANAGED 块外的用户代码，发现 develop 分支在用户代码和新配置中都有处理，报告 type A 冲突（条件重叠），提供三个选项让用户决策后再写入。",
+      "assertions": []
+    }
+  ]
+}