@double-codeing/flow2spec 3.1.0 → 3.1.2

package/docs//350/256/276/350/256/241/350/257/264/346/230/216.md

@@ -27,12 +27,12 @@
 
 仓内 **四环**（规则环与技能环分列，勿合并为「规则+技能」）：
 
-| 环 | 落点 | 职责 |
-| --- | --- | --- |
-| 知识环 | `.Knowledge/` | 路由 + 主题 + 存量/需求文档 |
-| 任务环 | `.task/` | 跨会话续作、用户代办 |
+| 环     | 落点                         | 职责                                 |
+| ------ | ---------------------------- | ------------------------------------ |
+| 知识环 | `.Knowledge/`                | 路由 + 主题 + 存量/需求文档          |
+| 任务环 | `.task/`                     | 跨会话续作、用户代办                 |
 | 规则环 | 各工具 `rules` / `AGENTS.md` | 怎么读、怎么做（缺口闸门、路由顺序） |
-| 技能环 | `f2s-*` / `skills/` | 维护知识、触发 feat/fix/sync 等 |
+| 技能环 | `f2s-*` / `skills/`          | 维护知识、触发 feat/fix/sync 等      |
 
 ```mermaid
 graph TB
@@ -72,13 +72,13 @@ graph TB
     L2 --- V
 ```
 
-| 层级 | 路径 | 作用 |
-| --- | --- | --- |
-| L0 | `manifest-routing.json` | 机读路由、依赖声明 |
-| L1 | `matchers/*.json` | 关键词命中，**match** 只读一片 |
-| L2 | `topics/*.md` | 硬约束摘要；**expand** 拉依赖 |
-| L3 | `stock-docs/`、`req-docs/` | 长文档，按需下钻 |
-| 纵链 | `topicDependencies` | 主题级前置，所有任务共享 |
+| 层级 | 路径                       | 作用                           |
+| ---- | -------------------------- | ------------------------------ |
+| L0   | `manifest-routing.json`    | 机读路由、依赖声明             |
+| L1   | `matchers/*.json`          | 关键词命中，**match** 只读一片 |
+| L2   | `topics/*.md`              | 硬约束摘要；**expand** 拉依赖  |
+| L3   | `stock-docs/`、`req-docs/` | 长文档，按需下钻               |
+| 纵链 | `topicDependencies`        | 主题级前置，所有任务共享       |
 
 读取流水线：`match → expand → verify → act`（详见 [体系与原理 §4](./体系与原理.md)）。
 
@@ -105,8 +105,6 @@ graph LR
     note2["规则随工具升级"] -.-> R
 ```
 
-
-
 ### 2. 渐进式路由
 
 ```mermaid
@@ -120,8 +118,6 @@ graph LR
     M -->|未命中| FB[fallback-triage\n结构化分诊]
 ```
 
-
-
 ### 3. 技能维护闭环
 
 <p><img src="./images/flow-1.png" alt="技能维护闭环" style="max-width:100%;" /></p>
@@ -154,9 +150,7 @@ graph LR
 
 </details>
 
-七条入口  ·  `f2s-git-commit` 是提交时的知识纪律收口  ·  `.Knowledge/` 是唯一汇聚点  ·  知识驱动 AI，AI 驱动下轮开发
-
-
+七条入口 · `f2s-git-commit` 是提交时的知识纪律收口 · `.Knowledge/` 是唯一汇聚点 · 知识驱动 AI，AI 驱动下轮开发
 
 ### 4. 任务清单与跨会话续作
 
@@ -170,10 +164,53 @@ graph LR
     LD --> RS[按原技能约束继续]
 ```
 
-任务不因会话结束丢失  ·  关键词自动续作，无需重新说明上下文  ·  技能约束完整恢复
+任务不因会话结束丢失 · 关键词自动续作，无需重新说明上下文 · 技能约束完整恢复
 
 ---
 
+### 5.知识库更新检测
+
+```mermaid
+flowchart LR
+    A[用户执行 flow2spec init codex] --> B[写入 .codex/hooks/f2s-update-check.js]
+    A --> C[写入 .codex/hooks.json]
+
+    C --> D[注册 Codex SessionStart hook]
+    D --> E[matcher: startup|resume]
+    E --> F[command: node .codex/hooks/f2s-update-check.js]
+
+    G[Codex 新 session 启动或恢复] --> H{项目 hook 已信任?}
+    H -- 否 --> H1[Codex 提示通过 /hooks 审核并信任]
+    H1 --> H2[本次 hook 不自动执行]
+    H -- 是 --> F
+
+    F --> I{CI 环境?}
+    I -- 是 --> Z[静默跳过]
+    I -- 否 --> J{updateCheck.enabled=false?}
+
+    J -- 是 --> Z
+    J -- 否 --> K{.Knowledge/update-check.json 今天已检查?}
+
+    K -- 是 --> K1{缓存显示需升级?}
+    K1 -- 否 --> Z
+    K1 -- 是 --> Q
+    K -- 否 --> L[读取 .Knowledge/manifest-routing.json version]
+
+    L --> M{有 manifest version?}
+    M -- 否 --> Z
+    M -- 是 --> N[npm view 当前包名 version]
+
+    N --> O[写入 .Knowledge/update-check.json 缓存]
+    O --> P{manifest version < npm latest?}
+
+    P -- 否 --> Z
+    P -- 是 --> Q[stdout 输出 JSON]
+
+    Q --> R[hookSpecificOutput.additionalContext]
+    R --> S[Codex 把提示注入会话上下文]
+    S --> T[提示用户执行 f2s-kb-upgrade]
+```
+
 ## 设计亮点
 
 ### 一、路由与上下文加载
@@ -220,7 +257,7 @@ taskC → [main]      ← 漏写了
 └──────────────────────────────────────────┘
 ```
 
-路由层保持轻量  ·  执行细节按需加载  ·  两者独立更新
+路由层保持轻量 · 执行细节按需加载 · 两者独立更新
 
 #### 4. 禁止全量扫描是硬约束
 
@@ -251,7 +288,7 @@ description: >
 用户输入 → Agent 扫 description 做语义匹配 → 触发对应技能
 ```
 
-触发词在 description 里  ·  不在正文里  ·  命中率更高  ·  双语覆盖减少漏触发
+触发词在 description 里 · 不在正文里 · 命中率更高 · 双语覆盖减少漏触发
 
 ---
 
@@ -300,7 +337,7 @@ git log .Knowledge/
   代码变更  +  知识变更  →  同一 commit 或相邻 commit
 ```
 
-知识有版本  ·  可 review  ·  可回溯  ·  可 blame
+知识有版本 · 可 review · 可回溯 · 可 blame
 
 #### 4. 禁止历史否定堆砌
 
@@ -313,7 +350,7 @@ git log .Knowledge/
   → 原写法已废弃，现改为 Bean 注入
 ```
 
-每次修复原位改写  ·  不叠加历史  ·  知识库永远只描述现在
+每次修复原位改写 · 不叠加历史 · 知识库永远只描述现在
 
 ---
 
@@ -337,7 +374,7 @@ implement-tech-design 执行流
   输出待完成清单与提醒   ← 不可跳过
 ```
 
-建议 → 可以被跳过  ·  约束 → 必须明确处理才能继续
+建议 → 可以被跳过 · 约束 → 必须明确处理才能继续
 
 #### 2. fallback 本身是有程序的 topic
 
@@ -351,9 +388,7 @@ graph TD
     Q -->|不确定| STOP[停止执行\n等待明确指令]
 ```
 
-
-
-未命中 ≠ 静默失败  ·  降级本身有明确程序
+未命中 ≠ 静默失败 · 降级本身有明确程序
 
 #### 3. manifest / index 写权硬约束
 
@@ -380,7 +415,7 @@ matchers/*.json（diff 模式）
                                   ❌ 整文件重写严格禁止
 ```
 
-原因：文档需要保证「现行真值覆盖 / 文风一致 / 禁历史否定堆砌」  ·  要求写的人看到全文上下文
+原因：文档需要保证「现行真值覆盖 / 文风一致 / 禁历史否定堆砌」 · 要求写的人看到全文上下文
 
 #### 5. 任务清单与跨会话续作
 
@@ -413,7 +448,7 @@ todo.json 写权约束
   原因：多子 agent 并行落盘时，并发写会导致条目互相覆盖
 ```
 
-生命周期由技能驱动  ·  关键词路由实现跨会话自动续作  ·  linkedSkill 保证技能约束完整恢复
+生命周期由技能驱动 · 关键词路由实现跨会话自动续作 · linkedSkill 保证技能约束完整恢复
 
 ---
 
@@ -435,7 +470,7 @@ todo.json 写权约束
                └────────────┴─────────────────┘
 ```
 
-两个维度正交  ·  独立配置  ·  默认左下角
+两个维度正交 · 独立配置 · 默认左下角
 
 #### 2. 确认权不可下放子 agent
 
@@ -450,9 +485,7 @@ graph LR
     S3[步骤3: 落盘] -->|subAgent=true 可并行| SUB2[子 agent]
 ```
 
-
-
-用户对话只经过主 agent  ·  确认决策不可绕过用户  ·  子 agent 只做执行不做决策
+用户对话只经过主 agent · 确认决策不可绕过用户 · 子 agent 只做执行不做决策
 
 #### 3. 技能可覆盖全局 subAgent 配置
 
@@ -466,7 +499,7 @@ subAgent: true               本技能默认不拆子：
      拆子会断上下文，导致澄清质量下降
 ```
 
-全局配置是允许拆的上限  ·  技能自己判断是否适合拆  ·  配置 true 不等于一定拆
+全局配置是允许拆的上限 · 技能自己判断是否适合拆 · 配置 true 不等于一定拆
 
 #### 4. f2s-kb-sync 先出大纲，确认后再写
 
@@ -479,9 +512,7 @@ graph LR
     U -->|取消| STOP[不写入]
 ```
 
-
-
-写入是破坏性操作  ·  大纲是用户唯一的纠错机会  ·  确认前不落盘
+写入是破坏性操作 · 大纲是用户唯一的纠错机会 · 确认前不落盘
 
 #### 5. 零输入推断
 
@@ -496,18 +527,20 @@ f2s-kb-sync 三种输入方式
                                   本次实现了什么、有什么值得沉淀
 ```
 
-会话上下文本身就是信息源  ·  不需要用户整理再输入
+会话上下文本身就是信息源 · 不需要用户整理再输入
 
 #### 5.1 执行开关如何进入 Agent（多端提示）
 
 `flow2spec.config.json` 决定 **`subAgent` / `switchAgentVerification` / `changeTracking`**，但各 AI 产品**不保证**会话启动即自动打开该文件。设计上用 **多条弱约束叠加** 降低「未读配置就开跑 `f2s-*`」的概率，同时避免在 `.Knowledge` 再维护一份与 `.codex/topics/f2s-config-check.md` 逐字重复的长文：
 
-| 机制 | 设计意图 |
-| --- | --- |
-| **Cursor `f2s-config-check.mdc`** | 规则层强制「技能正文前先 Read」。 |
-| **Claude `f2s-config-inject` PreToolUse** | 在调用 **`f2s-*` Skill** 时注入解析结果；**缺文件 / 坏 JSON / hook 异常**仍输出说明与默认语义，避免静默。 |
-| **Codex `AGENTS.md` + `renderProjectConfigBlock`** | 顶部 **Read** 硬约束 + **init 快照表**（与磁盘不一致时以 Read 为准）。 |
-| **知识库 `config-precheck` 主题** | 路由命中时只提供**摘要**与链向 Codex 长文，**不**替代 Read JSON。 |
+| 机制                                                        | 设计意图                                                                          |
+| ----------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| **Cursor `f2s-config-check.mdc`**                           | 规则层强制「技能正文前先 Read」；Cursor hook 仅用于版本更新检测，不自动读取配置。 |
+| **Claude `f2s-config-session` SessionStart**                | 会话开始时注入一次配置摘要，降低遗忘概率。                                        |
+| **Claude `f2s-config-inject` PreToolUse**                   | 仅在调用 **`f2s-*` Skill** 时做守门提示，提醒首步必须 Read；不反复注入完整配置。  |
+| **Codex `AGENTS.md` / `.codex/topics/f2s-config-check.md`** | 文本层强制「技能正文前先 Read」；Codex hook 仅用于版本更新检测，不自动读取配置。  |
+| **Codex `AGENTS.md` + `renderProjectConfigBlock`**          | 顶部 **Read** 硬约束 + **init 快照表**（与磁盘不一致时以 Read 为准）。            |
+| **知识库 `config-precheck` 主题**                           | 路由命中时只提供**摘要**与链向 Codex 长文，**不**替代 Read JSON。                 |
 
 **权威仍为**项目根 JSON 的 **Read** 结果；各层为提示而非第二份真值源。操作侧完整表格与路径见 **[使用说明 § 一、`f2s-*` 与 `flow2spec.config.json`](./使用说明.md)**；口述节奏见 **[Flow2Spec-演讲稿 Slide 13b](./Flow2Spec-演讲稿.md)**。
 
@@ -540,7 +573,7 @@ flow2spec init cursor codex          ← 跳过 Claude
 .Knowledge/ 始终不变，工具随时加减
 ```
 
-同一份 `.Knowledge/` 驱动所有工具  ·  加减工具不影响知识内容  ·  新工具接入零重建
+同一份 `.Knowledge/` 驱动所有工具 · 加减工具不影响知识内容 · 新工具接入零重建
 
 #### 2. 知识主题可插拔：增删不连带
 
@@ -555,7 +588,7 @@ flow2spec init cursor codex          ← 跳过 Claude
 其他主题完全不受影响
 ```
 
-新主题只需在 `topicDependencies` 里声明依赖  ·  不声明则彼此独立  ·  删除无副作用
+新主题只需在 `topicDependencies` 里声明依赖 · 不声明则彼此独立 · 删除无副作用
 
 #### 3. 技能可插拔：自包含单元，项目级可覆盖包级
 
@@ -569,13 +602,13 @@ f2s-doc-arch/SKILL.md                 my-review-skill/SKILL.md
 名字不冲突则共存  ·  同名则项目级覆盖包级  ·  互不感知
 ```
 
-技能靠 `description` 字段自描述触发词  ·  不需要注册表  ·  不需要改全局配置  ·  上线即生效
+技能靠 `description` 字段自描述触发词 · 不需要注册表 · 不需要改全局配置 · 上线即生效
 
 #### 4. 路由词表可插拔：分片隔离，局部更新
 
 词条变更只改对应 `matchers/m-xxx.json`，其他路由 diff 为零；结构见「[一、路由与上下文加载 → matchers 分片](#matchers-分片不嵌入-manifest)」。
 
-词条变更局部化  ·  合并冲突最小化  ·  新增路由不影响存量
+词条变更局部化 · 合并冲突最小化 · 新增路由不影响存量
 
 #### 5. 执行模型可插拔：config 按项目切换
 
@@ -588,13 +621,14 @@ flow2spec.config.json
   switchAgentVerification: false → 落盘侧自验，日常使用
   switchAgentVerification: true  → 交叉校验，高置信度关键场景
 
-  changeTracking.feat/fix/implement: false → 不创建任务清单
-  changeTracking.feat/fix/implement: true  → 对应技能执行时自动创建任务清单，支持跨会话续作
+  changeTracking.feat: true        → f2s-kb-feat 默认创建任务清单
+  changeTracking.fix: false        → f2s-kb-fix 默认不创建任务清单
+  changeTracking.implement: true   → implement-tech-design 默认创建任务清单
 
   三个维度正交 · 各技能可进一步细化覆盖全局配置
 ```
 
-改一行配置切换执行策略  ·  不修改任何技能文件  ·  新项目开箱即用，老项目按需升级
+改一行配置切换执行策略 · 不修改任何技能文件 · 新项目开箱即用，老项目按需升级
 
 ---
 
@@ -641,4 +675,3 @@ flow2spec.config.json
 - [体系与原理](./体系与原理.md)
 - [使用案例-模拟对话](./使用案例-模拟对话.md)
 - [Flow2Spec-演讲稿](./Flow2Spec-演讲稿.md)
-

package/lib/claudeSettingsAdapter.js

@@ -6,19 +6,19 @@
 const fs = require('fs');
 const path = require('path');
 
-const HOOK_COMMAND = 'node .claude/hooks/f2s-config-inject.js';
+const HOOK_COMMAND_CONFIG_INJECT = 'node .claude/hooks/f2s-config-inject.js';
+const HOOK_COMMAND_CONFIG_SESSION = 'node .claude/hooks/f2s-config-session.js';
+const HOOK_COMMAND_UPDATE_CHECK  = 'node .claude/hooks/f2s-update-check.js';
 
-/**
- * 判断 PreToolUse 数组里是否已存在 f2s-config-inject hook。
- * @param {Array} preToolUseArr
- * @returns {boolean}
- */
-function hasF2sHook(preToolUseArr) {
-  if (!Array.isArray(preToolUseArr)) return false;
-  for (const group of preToolUseArr) {
+// 向下兼容
+const HOOK_COMMAND = HOOK_COMMAND_CONFIG_INJECT;
+
+function hasHookCommand(arr, fragment) {
+  if (!Array.isArray(arr)) return false;
+  for (const group of arr) {
     if (!group || !Array.isArray(group.hooks)) continue;
     for (const h of group.hooks) {
-      if (h && h.type === 'command' && String(h.command || '').includes('f2s-config-inject')) {
+      if (h && h.type === 'command' && String(h.command || '').includes(fragment)) {
         return true;
       }
     }
@@ -26,8 +26,29 @@ function hasF2sHook(preToolUseArr) {
   return false;
 }
 
+function removeHookCommand(arr, fragment) {
+  if (!Array.isArray(arr)) return [];
+  const next = [];
+  for (const group of arr) {
+    if (!group || !Array.isArray(group.hooks)) {
+      next.push(group);
+      continue;
+    }
+    const hooks = group.hooks.filter((h) => {
+      return !(h && h.type === 'command' && String(h.command || '').includes(fragment));
+    });
+    if (hooks.length) next.push(Object.assign({}, group, { hooks }));
+  }
+  return next;
+}
+
+// 旧函数名保持兼容
+function hasF2sHook(preToolUseArr) {
+  return hasHookCommand(preToolUseArr, 'f2s-config-inject');
+}
+
 /**
- * 将 f2s PreToolUse hook 合并进现有 settings，返回新对象（不修改原对象）。
+ * 将 f2s PreToolUse 守门 hook 合并进现有 settings，返回新对象（不修改原对象）。
  * @param {object} existing  现有 settings（可为 {}）
  * @returns {object}
  */
@@ -48,6 +69,61 @@ function mergeF2sHook(existing) {
   return { settings: next, changed: true };
 }
 
+/**
+ * 将 f2s SessionStart 配置摘要 hook 合并进 settings。
+ * @param {object} existing
+ * @returns {{ settings, changed }}
+ */
+function mergeConfigSessionHook(existing) {
+  const next = JSON.parse(JSON.stringify(existing || {}));
+  if (!next.hooks) next.hooks = {};
+  if (!next.hooks.SessionStart) next.hooks.SessionStart = [];
+
+  if (hasHookCommand(next.hooks.SessionStart, 'f2s-config-session')) {
+    return { settings: next, changed: false };
+  }
+
+  next.hooks.SessionStart.push({
+    hooks: [{ type: 'command', command: HOOK_COMMAND_CONFIG_SESSION }],
+  });
+
+  return { settings: next, changed: true };
+}
+
+/**
+ * 将 f2s 更新检查 hook 合并进 settings：
+ * - SessionStart：执行完整检测，写入 .Knowledge/update-check.json，并直接 emit 提示
+ * - 同时清理旧版 UserPromptSubmit 中的 f2s-update-check / f2s-update-notice
+ * @param {object} existing
+ * @returns {{ settings, changed }}
+ */
+function mergeUpdateCheckHook(existing) {
+  const next = JSON.parse(JSON.stringify(existing || {}));
+  if (!next.hooks) next.hooks = {};
+  if (!next.hooks.SessionStart) next.hooks.SessionStart = [];
+
+  let changed = false;
+
+  if (Array.isArray(next.hooks.UserPromptSubmit)) {
+    const before = JSON.stringify(next.hooks.UserPromptSubmit);
+    next.hooks.UserPromptSubmit = removeHookCommand(next.hooks.UserPromptSubmit, 'f2s-update-check');
+    next.hooks.UserPromptSubmit = removeHookCommand(next.hooks.UserPromptSubmit, 'f2s-update-notice');
+    if (JSON.stringify(next.hooks.UserPromptSubmit) !== before) changed = true;
+    if (next.hooks.UserPromptSubmit.length === 0) {
+      delete next.hooks.UserPromptSubmit;
+    }
+  }
+
+  if (!hasHookCommand(next.hooks.SessionStart, 'f2s-update-check')) {
+    next.hooks.SessionStart.push({
+      hooks: [{ type: 'command', command: HOOK_COMMAND_UPDATE_CHECK }],
+    });
+    changed = true;
+  }
+
+  return { settings: next, changed };
+}
+
 /**
  * 读取 .claude/settings.json（不存在则返回 {}）。
  * @param {string} claudeRoot  .claude 目录绝对路径
@@ -74,41 +150,69 @@ function writeSettings(claudeRoot, settings) {
 }
 
 /**
- * 将 templates/hooks/f2s-config-inject.js 复制到 .claude/hooks/。
- * @param {string} claudeRoot
- * @param {string} templatesDir
+ * 复制 hook 脚本到 .claude/hooks/。
  */
-function copyHookScript(claudeRoot, templatesDir) {
-  const src = path.join(templatesDir, 'hooks', 'f2s-config-inject.js');
+function copyHookScript(claudeRoot, templatesDir, scriptName) {
+  const src = path.join(templatesDir, 'hooks', scriptName);
   if (!fs.existsSync(src)) return { written: false, reason: 'missing-template' };
 
   const hooksDir = path.join(claudeRoot, 'hooks');
   if (!fs.existsSync(hooksDir)) fs.mkdirSync(hooksDir, { recursive: true });
 
-  const dest = path.join(hooksDir, 'f2s-config-inject.js');
-  fs.copyFileSync(src, dest);
+  let body = fs.readFileSync(src, 'utf8');
+  if (body.includes('__FLOW2SPEC_PACKAGE_NAME__')) {
+    let packageName = '@double-codeing/flow2spec';
+    try {
+      packageName = JSON.parse(
+        fs.readFileSync(path.join(templatesDir, '..', 'package.json'), 'utf8'),
+      ).name || packageName;
+    } catch (_) {}
+    body = body.replace(/__FLOW2SPEC_PACKAGE_NAME__/g, packageName);
+  }
+  fs.writeFileSync(path.join(hooksDir, scriptName), body, 'utf8');
   return { written: true };
 }
 
 /**
- * 主入口：为 claude agent 配置 f2s PreToolUse hook。
- * @param {string} cwd        项目根目录
- * @param {string} templatesDir  flow2spec 包 templates 目录
- * @returns {{ hookScriptResult, settingsChanged }}
+ * 主入口：为 claude agent 配置 f2s hooks（SessionStart 配置摘要 + PreToolUse 守门 + 更新检测/提示）。
+ * @param {string} cwd
+ * @param {string} templatesDir
+ * @returns {{ hookScriptResult, updateCheckResult, settingsChanged }}
  */
 function writeClaudeAgentHooks(cwd, templatesDir) {
   const claudeRoot = path.join(cwd, '.claude');
   if (!fs.existsSync(claudeRoot)) fs.mkdirSync(claudeRoot, { recursive: true });
 
-  const hookScriptResult = copyHookScript(claudeRoot, templatesDir);
+  const hookScriptResult = copyHookScript(claudeRoot, templatesDir, 'f2s-config-inject.js');
+  const configSessionResult = copyHookScript(claudeRoot, templatesDir, 'f2s-config-session.js');
+  const updateCheckResult = copyHookScript(claudeRoot, templatesDir, 'f2s-update-check.js');
 
-  const existing = readSettings(claudeRoot);
-  const { settings, changed } = mergeF2sHook(existing);
-  if (changed) {
-    writeSettings(claudeRoot, settings);
+  // 清理旧版残留的 f2s-update-notice.js
+  const noticeStale = path.join(claudeRoot, 'hooks', 'f2s-update-notice.js');
+  if (fs.existsSync(noticeStale)) {
+    try { fs.unlinkSync(noticeStale); } catch (_) {}
   }
 
-  return { hookScriptResult, settingsChanged: changed };
+  let settings = readSettings(claudeRoot);
+  let changed = false;
+
+  const r1 = mergeF2sHook(settings);
+  if (r1.changed) { settings = r1.settings; changed = true; }
+
+  const r2 = mergeConfigSessionHook(settings);
+  if (r2.changed) { settings = r2.settings; changed = true; }
+
+  const r3 = mergeUpdateCheckHook(settings);
+  if (r3.changed) { settings = r3.settings; changed = true; }
+
+  if (changed) writeSettings(claudeRoot, settings);
+
+  return { hookScriptResult, configSessionResult, updateCheckResult, settingsChanged: changed };
 }
 
-module.exports = { writeClaudeAgentHooks, mergeF2sHook };
+module.exports = {
+  writeClaudeAgentHooks,
+  mergeF2sHook,
+  mergeConfigSessionHook,
+  mergeUpdateCheckHook,
+};

package/lib/flow2specConfig.js

@@ -8,9 +8,12 @@ const DEFAULTS = {
   // switchAgentVerification：false=落盘侧同会话内验；true+技能绑定=交叉验（子落盘主验/主落盘子验）
   switchAgentVerification: false,
   changeTracking: {
-    feat: false,
+    feat: true,
     fix: false,
-    implement: false,
+    implement: true,
+  },
+  updateCheck: {
+    enabled: true,
   },
 };
 
@@ -35,7 +38,7 @@ const CONFIG_FIELDS = [
   {
     key: "changeTracking.feat",
     type: "boolean",
-    default: false,
+    default: true,
     question: "启用变更追踪 - f2s-kb-feat（新增能力时创建可续作的任务清单）？",
   },
   {
@@ -47,9 +50,15 @@ const CONFIG_FIELDS = [
   {
     key: "changeTracking.implement",
     type: "boolean",
-    default: false,
+    default: true,
     question: "启用变更追踪 - f2s-implement-tech-design（实现技术方案时创建可续作的任务清单）？",
   },
+  {
+    key: "updateCheck.enabled",
+    type: "boolean",
+    default: true,
+    question: "启用每日版本更新提示（每天第一次 Agent 对话时检查是否有新版 flow2spec）？",
+  },
 ];
 
 function normalizeBool(value, fallback) {
@@ -83,6 +92,7 @@ function loadFlow2specConfig(cwd) {
   const out = {
     ...DEFAULTS,
     changeTracking: { ...DEFAULTS.changeTracking },
+    updateCheck: { ...DEFAULTS.updateCheck },
   };
   if (!fs.existsSync(abs)) {
     return out;
@@ -126,6 +136,14 @@ function loadFlow2specConfig(cwd) {
       };
     }
   }
+  if (Object.prototype.hasOwnProperty.call(raw, "updateCheck")) {
+    const uc = raw.updateCheck;
+    if (uc && typeof uc === "object" && !Array.isArray(uc)) {
+      out.updateCheck = {
+        enabled: normalizeBool(uc.enabled, DEFAULTS.updateCheck.enabled),
+      };
+    }
+  }
   return out;
 }
 
@@ -209,10 +227,18 @@ function ensureFlow2specProjectConfig(cwd, templatesDir, options = {}) {
     try {
       base = JSON.parse(fs.readFileSync(src, "utf8"));
     } catch {
-      base = { ...DEFAULTS, changeTracking: { ...DEFAULTS.changeTracking } };
+      base = {
+        ...DEFAULTS,
+        changeTracking: { ...DEFAULTS.changeTracking },
+        updateCheck: { ...DEFAULTS.updateCheck },
+      };
     }
   } else {
-    base = { ...DEFAULTS, changeTracking: { ...DEFAULTS.changeTracking } };
+    base = {
+      ...DEFAULTS,
+      changeTracking: { ...DEFAULTS.changeTracking },
+      updateCheck: { ...DEFAULTS.updateCheck },
+    };
   }
   const merged = values && typeof values === "object" ? mergeValues(base, values) : base;
   fs.writeFileSync(dest, `${JSON.stringify(merged, null, 2)}\n`, "utf8");