harveyz-skill 0.19.0 → 0.22.0

package/CHANGELOG.md

@@ -7,6 +7,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.22.0] - 2026-07-06
+
+### Added
+- `capture-vocab`：项目级领域术语字典 skill，支持 add/query/update/remove，上下文自动推断字段
+
+### Changed
+- `sync-design` v5.0.0：模式路由（sync/design），设计阶段流程（新建/修改草稿），三检查点草稿删除，`linkedEntryId` 自动回填
+- `question-me` v3.0.0：重构为 section-structure 标准；v2.0.0 动态树 + 遍历顺序漏洞修复
+- `extract-url` v2.3.0：章节结构重组，新增 `count_article_stats.py` 完成回报卡片
+- `scout-philosophy`：新增阶段八——产出可直接复制的起始模板（`standard.md`）
+- `init-goal`：移至 `coding/` bundle，`installScope` 改为 global
+- `learn-skill`：移至 `mint` bundle
+
+### Removed
+- `dispatch-task`、`close-task`：归档
+
+## [0.21.0] - 2026-07-01
+
+### Added
+- `init-workflow` v4.1.x：Step 4e git config 健康检查（`core.hooksPath` + `merge.ff`），类型 E 冲突检测与自动修复；lock 文件新增 `git_config` 节
+- `sync-hotfix` v1.1.x：Step 5 全文件差异扫描安全网，Step 1 不再退出确保 Step 5 始终执行
+- `extract-url` v2.2.0：X Notes 内容根节点修复、嵌套 tweet 过滤；tag 固定集（`fixed_tags.txt`）与候选集分离，两阶段打标流程
+- `fix-skill` v2.1.0：多轮 AI 修复 + per-skill session doc（含 HOTFIXES.md 写入）
+- `extract-cognition` v0.2.0：学习导向重设计——五阶段 evidence/audit layer + 学习层（Stage 5-6）
+- `skill-map.html`：全景参考页面，Grid 布局按 bundle 分组展示所有 35 个 skill
+- `sync-design` v3.1.0：`.hskill/` outputDir 默认路径 + legacy path 迁移
+
+### Changed
+- Bundle 重组：`meta` 拆分为 `mint`（skill 生命周期）和 `devops`（项目运维）；`experiment` 解散，各 skill 回归领域 bundle
+- `publish-skill` v1.3.1：F7 动词词表新增 `survey`
+- `capture-todo` v4.5.1：修复 merge dual-hook 兼容性（`--no-commit` 解耦 MERGE_MSG 与 commit-msg）
+- Pre-commit hook：允许 remote staging sync merge 不被拦截
+
+### Removed
+- `manage-docs`：归档（功能已由 `manage-dir` + `references/built-in/diataxis.md` 覆盖）
+
+## [0.20.0] - 2026-06-25
+
+### Added
+- `init-goal`：对话式向导 skill，为 `/loop` 命令生成结构化 Goal Prompt 文本；深度优先解析用户输入、自动匹配五类模版（Fix Until Green / Research Loop / Refine Until Satisfied / Monitor & React / Explore & Map）、渐进式披露（模版数据提取至 references/templates.md）
+- `learn-video`：新增 Bilibili 视频支持（YouTube + Bilibili 双平台）
+
+### Changed
+- `init-goal`：迁移至 `coding` bundle（原 `meta`）
+
 ## [0.19.0] - 2026-06-22
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.19.0",
+  "version": "0.22.0",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -16,38 +16,42 @@
     "bundles.json",
     "skills-index.json",
     "CHANGELOG.md",
-    "skills/research/learn-skill/",
+    "skills/mint/learn-skill/",
     "skills/research/extract-url/",
     "skills/research/extract-vision/",
     "skills/research/learn-video/",
+    "skills/research/survey-skillrepo/",
+    "skills/research/learn-paper/",
+    "skills/research/extract-cognition/",
+    "skills/research/probe-session/",
     "skills/creative/capture-todo/",
     "skills/creative/capture-insight/",
     "skills/coding/init-workflow/",
     "skills/coding/setup-debug/",
-    "skills/coding/dispatch-task/",
-    "skills/coding/close-task/",
+    "skills/coding/init-goal/",
+    "skills/coding/question-me/",
+    "skills/coding/capture-vocab/",
     "skills/writing/forge-doc/",
     "skills/writing/draw-diagram/",
-    "skills/writing/manage-docs/",
     "skills/writing/manage-dir/",
     "skills/writing/migrate-spec/",
     "skills/design/scout-brand/",
     "skills/design/build-style/",
     "skills/design/sync-design/",
-    "skills/experiment/init-skill/",
-    "skills/research/survey-skillrepo/",
+    "skills/mint/init-skill/",
+    "skills/mint/publish-skill/",
+    "skills/mint/archive-skill/",
+    "skills/mint/dedup-skill/",
+    "skills/mint/contribute-skill/",
+    "skills/mint/fix-skill/",
+    "skills/mint/runby-opencode/",
+    "skills/mint/scout-philosophy/",
     "skills/meta/clean-git/",
-    "skills/meta/archive-skill/",
-    "skills/meta/dedup-skill/",
-    "skills/meta/contribute-skill/",
-    "skills/meta/publish-skill/",
-    "skills/meta/runby-opencode/",
     "skills/meta/release-project/",
+    "skills/meta/sync-hotfix/",
     "skills/meta/sync-agent/",
-    "skills/experiment/probe-session/",
-    "skills/experiment/learn-paper/",
-    "skills/meta/scout-philosophy/",
     "tools/hub/",
+    "tools/sync-agent/",
     "hooks/check-similar-branch/"
   ],
   "engines": {

package/skills/coding/capture-vocab/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: capture-vocab
+version: "1.1.1"
+description: Use when you need to add, query, update, or remove project-specific domain terms — invoke with /capture-vocab add|query|update|remove <term> to manage a shared vocabulary file at hskill/capture-vocab/vocab.md
+user_invocable: true
+---
+
+# Domain Vocabulary
+
+## 概述
+
+管理项目级领域术语字典。词汇表存于 `hskill/capture-vocab/vocab.md`，供用户和 agent 定义、查询业务专有名词。每个术语包含：规范名称、定义、Avoid 列表、Reference（可选）。
+
+词汇表只存业务领域概念（跨前后端、跨 AI/人类对话都会出现的词）。函数名、变量名等技术命名不进词汇表。
+
+## 用法
+
+```
+/capture-vocab add <term>
+/capture-vocab query <term>
+/capture-vocab update <term>
+/capture-vocab remove <term>
+```
+
+## 词汇文件
+
+`<project-root>/hskill/capture-vocab/vocab.md`
+
+```markdown
+# Domain Vocabulary
+
+## 术语名
+定义文本（一到两句话，说清楚概念是什么）。
+_Avoid_: 旧叫法, 混用词
+_Reference_: src/models/order.ts:42, docs/business/order-flow.md
+```
+
+`_Avoid_:` 和 `_Reference_:` 均为可选，不填时省略该行。`_Reference_:` 为自由文本，可写代码文件路径+行号、文档位置、任意引用。
+
+## 操作
+
+### add `<term>`
+
+1. 检查 `hskill/capture-vocab/vocab.md` 是否存在 `## <term>` section（大小写不敏感匹配）
+2. 若已存在：输出"术语 '<term>' 已存在，请用 `update` 修改"并退出
+3. 若不存在，**先从当前对话上下文推断**各字段：
+   - **定义**：从对话中该词的使用方式推断一到两句话的定义；无法推断则留空
+   - **Avoid**：从对话中出现过的同义词或混用叫法推断；无法推断则留空
+   - **Reference**：从对话中提到的代码文件/文档位置推断；无法推断则留空
+4. 展示推断结果，格式如下，请用户确认或修改：
+   ```
+   准备添加以下条目，请确认或直接修改：
+
+   ## <term>
+   <推断的定义，或"（请输入）"若无法推断>
+   _Avoid_: <推断的 avoid，或省略>
+   _Reference_: <推断的 reference，或省略>
+
+   确认添加？(y / 直接输入修改内容)
+   ```
+5. 用户确认后（输入 `y` 或不输入内容直接回车）写入；若用户输入了修改内容，用修改后的值写入
+6. 若目录 `hskill/capture-vocab/` 不存在，创建它；若 `vocab.md` 不存在，创建并写入 `# Domain Vocabulary\n`
+7. 在文件末尾追加新 section，Avoid/Reference 为空时省略对应行
+
+### query `<term>`
+
+1. 检查 `hskill/capture-vocab/vocab.md` 是否存在；若不存在，输出"词汇表尚未初始化，请先用 `add` 添加术语"并退出
+2. 按 `## <term>` 标题匹配（大小写不敏感），读取该 section 直到下一个 `##` 或文件末尾
+3. 返回该 section 的完整内容（定义 + Avoid + Reference）
+4. 若未找到，输出"未找到术语 '<term>'"，然后列出 vocab.md 中所有 `##` 标题作为已有术语名
+
+### update `<term>`
+
+1. 检查词汇表存在且包含该术语；若文件不存在或术语不存在，输出对应错误后退出
+2. 展示当前条目的完整内容
+3. **从当前对话上下文推断**需要更新的字段（定义/Avoid/Reference）；若无新信息可推断，各字段显示为原值
+4. 展示推断后的新条目，请用户确认或修改（格式同 add 步骤 4）
+5. 用最终值替换该 section 内容，写回文件；未修改的字段保持原值不变
+
+### remove `<term>`
+
+1. 检查词汇表存在且包含该术语；若不存在，输出对应错误后退出
+2. 展示该术语的当前条目
+3. 提示"确认删除 '<term>'？(y/N)"，等待用户输入
+4. 若输入 `y`：删除该 section（含前后空行），写回文件
+5. 若输入其他：输出"已取消"并退出
+
+## Agent 加载约定
+
+本 Skill 不自动注入词汇表到 session 上下文。如需在每次 session 开始时加载术语，在项目 `CLAUDE.md` 中加入：
+
+```markdown
+每次 session 开始，读取 `hskill/capture-vocab/vocab.md`（如存在）。
+```

package/skills/coding/init-goal/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: init-goal
+version: "1.3.0"
+description: "Generate a structured /loop Goal Prompt through guided dialogue. Parses user's initial message to auto-fill known fields and match the best template, then clarifies only what's missing (depth-first, one question at a time). Outputs the Goal Prompt as text — the skill writes no files; the loop agent persists prompt.md/log.md/summary.md during execution per the embedded rules. Triggers: user says /init-goal, 'initialize a loop goal', 'set up a GOal', 'help me use /loop to accomplish X', or describes a repetitive autonomous task they want Claude to run in a loop."
+user_invocable: true
+---
+
+# init-goal
+
+对话式向导，帮助用户为 `/loop` 命令生成一段结构化的 **Goal Prompt 文本**。
+
+**这个 skill 的唯一产物就是这段 Goal Prompt 文本。** 它内含「执行期间维护文档」的规则——这些规则是写给跑 loop 的 agent 的指令，由那个 agent 在执行 loop 时落盘三个文件。**init-goal 自己不创建任何目录、不写任何文件。**
+
+执行期间由 loop agent 生成的文件（slug 取自 GOAL）：
+- `~/.hskill/init-goal/<goal-slug>/prompt.md`（agent 首轮存档，静态不变）
+- `~/.hskill/init-goal/<goal-slug>/log.md`（agent 每轮追加）
+- `~/.hskill/init-goal/<goal-slug>/summary.md`（agent 退出时生成）
+
+**规则：每次只发一条消息，等用户回复后再继续。**
+
+---
+
+## Step 0 — 解析输入，自动填充，深度优先澄清
+
+### 0a: 解析
+
+从用户的初始消息中提取所有已知信息，填入对应字段：
+
+| 字段 | 提取什么 |
+|---|---|
+| GOAL | 用户想达成的目标，含成功标准 |
+| EXECUTION | 用户描述的每轮步骤或动作 |
+| EVAL | 用户提到的衡量进展的方式 |
+| CONSTRAINTS | 用户提到的限制（不能改什么、最多多少轮…） |
+| EXIT_EXPLICIT | 用户提到的停止条件 |
+| EXIT_FALLBACK | 用户提到的兜底行为 |
+
+### 0b: 匹配模版
+
+根据用户描述，选最匹配的模版，用模版默认值填充所有**用户未提供**的字段：
+
+| 匹配信号 | 模版 |
+|---|---|
+| 测试 / test / bug / 修复 / fix | Fix Until Green |
+| 研究 / 搜索 / 信息收集 / search | Research Loop |
+| 优化 / 改进 / 迭代 / refine / 润色 | Refine Until Satisfied |
+| 监控 / 检查状态 / watch / monitor | Monitor & React |
+| 探索 / 代码库 / 结构 / map / 未知领域 | Explore & Map |
+| 无明显匹配 | 从零开始（所有字段留空） |
+
+置信度高时直接套用，不问用户确认模版名称。
+
+匹配后，读取 `references/templates.md` 中对应模版的字段值，填入用户未提供的字段。
+
+### 0c: 深度优先澄清
+
+按以下优先级，逐一澄清**缺失或不够具体**的字段。每次只问一个，等回复后再判断是否还需要继续问。
+
+**优先级（从高到低）：**
+
+1. **GOAL** — 如果目标不够具体（缺少成功标准、范围不清楚），先把这个搞清楚。其他一切从 GOAL 派生。
+2. **EXIT_EXPLICIT** — 如果用户没有明确说"达到什么状态停止"，问这个。这是 loop 的终点，必须清晰。
+3. **CONSTRAINTS** — 如果用户提到了限制但不完整（比如"不能改某些文件"但没说具体哪些），确认一下。
+4. **EXECUTION** — 如果模版默认步骤明显不适用当前场景，才问。通常不需要问。
+5. **EVAL / EXIT_FALLBACK** — 几乎不需要问；模版默认值在绝大多数情况下够用。
+
+**什么时候停止澄清：**
+- GOAL 足够具体（有明确的成功标准）
+- EXIT_EXPLICIT 已知
+- 其余关键字段都有合理的值（用户提供的或模版默认值）
+
+澄清完成后，进入 Step 1。
+
+---
+
+## Step 1 — 展示预填摘要，确认
+
+展示所有字段的当前值（用户已提供的 + 模版默认值），一次性呈现：
+
+---
+**这是根据你的描述整理的 loop 配置，请确认：**
+
+**目标：** [GOAL]
+
+**每轮执行：**
+[EXECUTION]
+
+**评估指标：** [EVAL]
+
+**约束：** [CONSTRAINTS]
+
+**退出条件：**
+- 明确：[EXIT_EXPLICIT]
+- 兜底：[EXIT_FALLBACK]
+
+---
+
+询问：「确认后直接生成文件，或告诉我需要调整哪个字段。」
+
+若用户要调整，只修改被指出的字段，重新展示摘要。直到用户确认。
+
+---
+
+## Step 2 — 生成并输出 Goal Prompt 文本
+
+这一步**不写任何文件**。init-goal 的产物就是下面这段文本——把它生成出来，直接展示给用户，由用户拿去喂给 `/loop`。文本里的 `## 文档维护` 段是写给执行 loop 的 agent 的指令，三个文档由那个 agent 在跑 loop 时落盘。
+
+**先生成 goal-slug：**
+若 GOAL 是英文，转为 kebab-case（小写 + 连字符），截取前 40 字符。
+若 GOAL 是中文，生成一个简短的英文描述（5-8 个单词，kebab-case）。
+把生成的 slug 填进下面文本里所有 `[goal-slug]` 占位处。
+
+**生成并展示这段 Goal Prompt 文本**（占位符全部替换为实际值后呈现）：
+
+```markdown
+## GOal
+
+[GOAL]
+
+## 每轮执行
+
+[EXECUTION]
+
+## 评估（每轮末尾）
+
+[EVAL]
+
+## 约束
+
+[CONSTRAINTS]
+
+## 退出条件
+
+- 明确条件：[EXIT_EXPLICIT]
+- 兜底逻辑：[EXIT_FALLBACK]
+
+## 文档维护（由运行本 loop 的 agent 负责，工作目录 ~/.hskill/init-goal/[goal-slug]/）
+
+- **首轮：** 若 prompt.md 不存在，`mkdir -p` 工作目录并把本 prompt 完整存为 prompt.md（静态存档，之后不改）。
+- **每轮：** 开始前读 log.md 末条 Round 获取上下文（首轮无则跳过）；结束时向 log.md 追加一条 `### Round N — YYYY-MM-DD HH:MM`，含三行——执行内容 / 评估结果 / 下一轮建议。
+- **退出时**（明确条件 / 兜底 / 用户中断）：在同目录写 summary.md，含——目标、结果（一句话）、关键轮次、退出原因、总轮数、可选下一步。
+```
+
+**展示完文本后，附上启动说明：**
+
+---
+✅ Goal Prompt 已生成（如上）。复制整段，启动 loop（interval 自选）：
+
+```
+/loop <interval> <粘贴上面整段 Goal Prompt>
+```
+
+首轮运行时，loop agent 会按 `## 文档维护` 的指令把它存为 `~/.hskill/init-goal/[goal-slug]/prompt.md`，每轮追加 `log.md`，结束时写 `summary.md`。
+
+---

package/skills/coding/init-goal/references/templates.md

@@ -0,0 +1,78 @@
+# init-goal 模版数据
+
+套用模版时读取此文件，取对应模版的字段值填入未由用户提供的字段。
+
+---
+
+## Fix Until Green
+
+```
+GOAL: 持续修复代码问题，直到所有测试通过。
+EXECUTION:
+1. 运行测试套件，记录当前通过数和失败列表
+2. 分析失败用例，定位根因
+3. 针对根因做最小化修复（每轮最多修改 3 个文件，不修改测试文件）
+4. 重新运行测试，记录新的通过数
+EVAL: 测试通过率（通过数 / 总数），本轮净增通过数。
+CONSTRAINTS: 不修改测试文件本身；每轮最多修改 3 个源文件。
+EXIT_EXPLICIT: 所有测试通过（通过率 100%）
+EXIT_FALLBACK: 连续 2 轮通过率无变化则停止，汇报当前卡点和失败原因。
+```
+
+## Research Loop
+
+```
+GOAL: 持续搜索和整理信息，直到对目标主题有足够深度的理解。
+EXECUTION:
+1. 回顾当前已知信息和未解答的问题
+2. 选择下一个最有价值的搜索方向（不重复已用关键词组合）
+3. 执行搜索（每轮不超过 5 个查询）
+4. 摘要新发现，追加到 log
+EVAL: 本轮新增有效信息条数；预设问题中已有答案的比例。
+CONSTRAINTS: 每轮搜索不超过 5 个查询；不重复已搜索过的关键词组合。
+EXIT_EXPLICIT: 所有预设问题均已有答案，且连续 1 轮无新发现。
+EXIT_FALLBACK: 连续 2 轮无新发现则停止，输出当前已知信息汇总。
+```
+
+## Refine Until Satisfied
+
+```
+GOAL: 反复优化指定输出，直到质量达到满意标准。
+EXECUTION:
+1. 评审当前版本，列出最重要的 3 个改进点
+2. 执行改进（每轮只改 3 处，不推翻上一轮已确认的改动）
+3. 对新版本自评分（1-10），说明理由
+EVAL: 自评分（1-10），记录分数变化趋势。
+CONSTRAINTS: 每轮只改进不超过 3 处；不推翻上一轮已确认的改动。
+EXIT_EXPLICIT: 自评分 ≥ 8。
+EXIT_FALLBACK: 连续 2 轮分数不再提升则停止，说明当前瓶颈。
+```
+
+## Monitor & React
+
+```
+GOAL: 持续监控指定状态，发现变化时执行响应动作。
+EXECUTION:
+1. 检查目标状态
+2. 与上轮状态（见 log 最后条目）对比，判断是否有变化
+3. 若有变化则执行预定响应动作（仅限预定范围）
+4. 记录本轮状态快照
+EVAL: 状态是否稳定；本轮是否触发响应动作。
+CONSTRAINTS: 响应动作仅限预定范围，不做范围外操作。
+EXIT_EXPLICIT: 目标状态连续 3 轮稳定。
+EXIT_FALLBACK: 超过 20 轮未达到稳定则停止并上报当前状态。
+```
+
+## Explore & Map
+
+```
+GOAL: 系统性探索未知领域/代码库，建立完整的结构地图。
+EXECUTION:
+1. 从未探索节点中选择下一个最重要的节点
+2. 深入分析该节点（结构、依赖、行为）
+3. 记录发现与关联，更新探索进度
+EVAL: 已探索节点数 / 总节点估算数；覆盖率百分比。
+CONSTRAINTS: 每轮只深入一个节点；不跳跃式探索。
+EXIT_EXPLICIT: 覆盖率达到目标阈值，或确认无新节点。
+EXIT_FALLBACK: 连续 2 轮无新节点则汇总已知结构并停止。
+```

package/skills/coding/init-goal/tests/init-goal.bats

@@ -0,0 +1,83 @@
+#!/usr/bin/env bats
+
+SKILL_MD="$(cd "${BATS_TEST_DIRNAME}/.." && pwd)/SKILL.md"
+
+_fm() {
+  local field="$1"
+  awk 'BEGIN{n=0} /^---/{n++; if(n==2)exit; next} n==1{print}' "${SKILL_MD}" \
+    | grep "^${field}:" | head -1 \
+    | sed "s/^${field}:[[:space:]]*//" | tr -d '"'"'"
+}
+
+@test "SKILL.md exists" {
+  [ -f "${SKILL_MD}" ]
+}
+
+@test "frontmatter: name is init-goal" {
+  [ "$(_fm name)" = "init-goal" ]
+}
+
+@test "frontmatter: version is present and semver-like" {
+  local v
+  v="$(_fm version)"
+  [ -n "${v}" ]
+  echo "${v}" | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$'
+}
+
+@test "frontmatter: user_invocable is true" {
+  [ "$(_fm user_invocable)" = "true" ]
+}
+
+@test "frontmatter: description is non-empty" {
+  local d
+  d="$(_fm description)"
+  [ -n "${d}" ]
+}
+
+@test "body: contains the three core steps (0/1/2)" {
+  grep -q "## Step 0" "${SKILL_MD}"
+  grep -q "## Step 1" "${SKILL_MD}"
+  grep -q "## Step 2" "${SKILL_MD}"
+}
+
+@test "body: Step 0 has parse/template/clarify sub-steps (0a/0b/0c)" {
+  grep -q "0a" "${SKILL_MD}"
+  grep -q "0b" "${SKILL_MD}"
+  grep -q "0c" "${SKILL_MD}"
+}
+
+@test "body: skill outputs Goal Prompt text, does not write files itself" {
+  grep -q "唯一产物" "${SKILL_MD}"
+  grep -q "不写任何文件" "${SKILL_MD}"
+}
+
+@test "body: doc-lifecycle rules are addressed to the loop agent" {
+  grep -q "## 文档维护" "${SKILL_MD}"
+  grep -q "运行本 loop 的 agent" "${SKILL_MD}"
+}
+
+@test "body: contains all 5 template names" {
+  grep -q "Fix Until Green" "${SKILL_MD}"
+  grep -q "Research Loop" "${SKILL_MD}"
+  grep -q "Refine Until Satisfied" "${SKILL_MD}"
+  grep -q "Monitor & React" "${SKILL_MD}"
+  grep -q "Explore & Map" "${SKILL_MD}"
+}
+
+@test "body: prompt.md output format includes all required sections" {
+  grep -q "## GOal" "${SKILL_MD}"
+  grep -q "## 每轮执行" "${SKILL_MD}"
+  grep -q "## 评估" "${SKILL_MD}"
+  grep -q "## 约束" "${SKILL_MD}"
+  grep -q "## 退出条件" "${SKILL_MD}"
+  grep -q "## 文档维护" "${SKILL_MD}"
+}
+
+@test "body: references log.md and summary.md" {
+  grep -q "log.md" "${SKILL_MD}"
+  grep -q "summary.md" "${SKILL_MD}"
+}
+
+@test "body: references ~/.hskill/init-goal data directory" {
+  grep -q "~/.hskill/init-goal" "${SKILL_MD}"
+}

package/skills/coding/init-workflow/SKILL.md

@@ -2,7 +2,7 @@
 name: init-workflow
 description: "Initialize or update git branch management standards: reads .hskill/init-workflow/workflow-config.yml, audits config, incrementally generates and deploys git hooks (pre-commit, commit-msg, pre-push, post-checkout), and generates workflow docs. Triggers: initializing a new git repo, first-time git setup, user asks to set/update branch protection or naming rules, reinstalling git hooks, or syncing after skill/template updates."
 user_invocable: true
-version: "4.1.0"
+version: "4.1.2"
 ---
 
 # Git 工作流初始化
@@ -79,7 +79,22 @@ echo "" | grep -E "<pattern>" > /dev/null 2>&1; echo $?
 提取每个 hook 中 MANAGED 块外的用户手写代码，识别其中引用的分支名、提交类型、pattern、外部脚本调用。
 
 #### 4d. 冲突检测
-综合 4a/4b/4c，识别四种冲突类型（A 条件重叠、B 引用断裂、C 手改冲突、D 新增重叠）。类型定义与选项见 `references/conflict-analysis.md`。
+综合 4a/4b/4c，识别四种冲突类型（A 条件重叠、B 引用断裂、C 手改冲突、D 新增重叠）；第五种类型 E（git config 漂移）由 Step 4e 另行检测。类型定义与选项见 `references/conflict-analysis.md`。
+
+#### 4e. git config 健康检查
+
+检查以下两项本地 git config：
+
+```bash
+git config --local core.hooksPath   # 期望：.githooks
+git config --local merge.ff         # 期望：false
+```
+
+1. 读取 lock 文件的 `git_config` 节（不存在则跳过对比，直接检测实际值）
+2. 执行上述命令，获取实际值
+3. 实际值与期望不符，或实际值缺失 → 类型 E 冲突
+
+类型 E 冲突在 Step 5 列出（附期望值 vs 实际值），默认选项为"自动修复（A）"。Step 6 写入 hooks 后立即执行修复命令。类型 E 完整定义见 `references/conflict-analysis.md`。
 
 ---
 
@@ -212,7 +227,8 @@ python3 <skill-path>/references/render_docs.py \
 .githooks/commit-msg               UNCHANGED
 .githooks/pre-push                 UNCHANGED
 .githooks/post-checkout            NEW
-core.hooksPath                     = .githooks
+core.hooksPath                     = .githooks  ✅（或 ❌ 已修复 / ❌ 未修复）
+merge.ff                           = false      ✅（或 ❌ 已修复 / ❌ 未修复）
 docs/reference/git-workflow.md     UPDATED
 CLAUDE.md                          已有引用，跳过
 ─────────────────────────────────────────────────────
@@ -222,6 +238,8 @@ CLAUDE.md                          已有引用，跳过
   [3/3] wip 类型引用断裂 → 用户选择保留用户代码
 ```
 
+首次安装时 Step 4 整体跳过，Step 6 直接设置两项配置；Step 9 对应行均显示 `✅`。
+
 若有保留的无法映射规则，附注提示。
 
 ---
@@ -231,7 +249,7 @@ CLAUDE.md                          已有引用，跳过
 | 文件 | 说明 | 读取时机 |
 |------|------|---------|
 | `references/workflow-config.yml` | 配置文件模板 | Step 2：用户无配置时复制 |
-| `references/conflict-analysis.md` | 4a–4d 实现脚本、冲突类型 A/B/C/D 完整定义与选项、Step 5 呈现格式 | Step 4/5：执行分析前读取 |
+| `references/conflict-analysis.md` | 4a–4e 实现脚本、冲突类型 A/B/C/D/E 完整定义与选项、Step 5 呈现格式 | Step 4/5：执行分析前读取 |
 | `references/hook-templates.md` | 4 个 hook 的代码模板、块 ID 规范、hash 计算、多行写入技巧 | Step 6：生成 hooks 前 |
 | `references/acceptance-test.md` | 验收场景 bash 脚本、期望结果、结果表格格式 | Step 6.5：用户选 Y 时读取 |
 | `references/lock-file-format.md` | lock 文件 YAML 格式 | Step 9：写入 lock 文件前 |

package/skills/coding/init-workflow/references/conflict-analysis.md

@@ -1,6 +1,6 @@
 # 冲突分析实现细节
 
-Step 4（4a–4d）的具体实现方法，Step 5 冲突类型的完整定义。
+Step 4（4a–4e）的具体实现方法，Step 5 冲突类型的完整定义。
 
 ---
 
@@ -124,3 +124,49 @@ actual_hash=$(printf '%s' "<block_content>" | git hash-object --stdin | cut -c1-
 ```
 
 其他冲突类型按同样格式呈现，选项见上方类型定义。
+
+---
+
+## 类型 E — git config 漂移
+
+**触发条件：** `core.hooksPath` 或 `merge.ff` 与期望值不符，或在本地 git config 中缺失。
+
+**严重程度：** 高（hooks 已部署但完全失效）
+
+**检测方式（Step 4e）：**
+
+```bash
+git config --local core.hooksPath   # 期望：.githooks
+git config --local merge.ff         # 期望：false
+```
+
+判定规则：
+- 值正确 → 无问题
+- 值存在但不正确 → 类型 E 冲突（配置漂移）
+- 值缺失（命令返回空 / exit 1） → 类型 E 冲突（配置丢失）
+
+lock 文件含 `git_config` 节时，优先与 lock 中记录的值对比；lock 缺失该节时直接检测实际值。
+
+**Step 5 呈现格式（每项独立列出，最多两条）：**
+
+```
+─────────────────────────────────────────────────────────
+[N/M] git config 漂移（类型 E）
+问题：core.hooksPath 未配置，.githooks/ 中的 hooks 不会被 git 加载
+期望：core.hooksPath = .githooks
+实际：（未设置）
+影响：所有分支保护、提交信息校验、push 限制均失效
+
+选项：
+  A) 自动修复（推荐）：运行 git config core.hooksPath .githooks
+  B) 跳过（保持当前状态，hooks 继续失效）
+─────────────────────────────────────────────────────────
+```
+
+`merge.ff` 缺失时替换对应字段：`问题` 改为"merge.ff 未配置，fast-forward 合并未被禁止"，`期望` 改为 `merge.ff = false`，`影响` 改为"所有合并均将 fast-forward，pre-commit hook 无法检查合并来源分支"。
+
+**默认选项：A（自动修复）。**
+
+**Step 6 修复执行时机：** 写入 hooks 后，对用户选择 A 的每一条类型 E 冲突立即执行对应的 `git config` 命令，无需用户手动操作。
+
+**用户选 B（跳过）时：** Step 9 对应行显示 `❌ 未修复`，并附注"hooks 当前不生效"。

package/skills/coding/init-workflow/references/lock-file-format.md

@@ -29,6 +29,11 @@ tags:
 push_rules:
   enforce: true
   block_force_push: [main, staging]
+git_config:
+  core_hooks_path: ".githooks"   # 上次运行时设置的值
+  merge_ff: "false"              # 上次运行时设置的值
 ```
 
-只记录影响 hook 生成的字段，不需要照搬 `workflow-config.yml` 的完整结构。
+只记录影响 hook 生成的字段，不需要照搬 `workflow-config.yml` 的完整结构。`git_config` 节与其他字段同属一个 YAML 文档，追加在末尾。
+
+**4e 读取逻辑（仅在 skill 重新运行时执行，首次安装时 Step 4 整体跳过）：** lock 文件缺少 `git_config` 节时（即 skill 在本功能加入前已运行过），跳过与 lock 的对比，直接检测当前实际值；若实际值不符或缺失，仍报类型 E 冲突。