Core v3.8.5

变更
新增 collaboration.syncActiveTasks（默认 true）：开启时仅忽略 .task/completed/ 与 .task/*/completed/，进行中任务可随 Git 跨电脑续作；关闭时整个 .task/ 留在本地。
init 按开关维护 .gitignore，支持同步与本地模式切换；doctor 按开关校验忽略规则，并展示 developerId 解析来源。
f2s-git-commit 与 f2s-task 模板补齐任务文件同步、敏感信息扫描、归档删除提交与跨机身份前提。
中英文文档与知识库主题统一口径。
验证
npm test
npm run pack:check

Core 3.8.5、CLI 3.6.8，Template 3.8.3。

CLI v3.6.8

变更
新增 collaboration.syncActiveTasks（默认 true）：开启时仅忽略 .task/completed/ 与 .task/*/completed/，进行中任务可随 Git 跨电脑续作；关闭时整个 .task/ 留在本地。
init 按开关维护 .gitignore，支持同步与本地模式切换；doctor 按开关校验忽略规则，并展示 developerId 解析来源。
f2s-git-commit 与 f2s-task 模板补齐任务文件同步、敏感信息扫描、归档删除提交与跨机身份前提。
中英文文档与知识库主题统一口径。
验证
npm test
npm run pack:check

Core 3.8.5、CLI 3.6.8，Template 3.8.3。

Core v3.8.4

变更

• 进行中的任务和 todo.json 可随代码通过 Git 同步，支持换电脑续作。
• 仅忽略 .task/completed/ 与 .task/*/completed/ 归档目录。
• init 自动迁移旧的整目录忽略规则，并保持重复执行稳定。
• doctor、CLI 帮助与中英文文档同步新规则。

验证

• npm test
• npm run pack:check

Core 3.8.4、CLI 3.6.7，Template 保持 3.8.2。

CLI v3.6.7

变更

• 进行中的任务和 todo.json 可随代码通过 Git 同步，支持换电脑续作。
• 仅忽略 .task/completed/ 与 .task/*/completed/ 归档目录。
• init 自动迁移旧的整目录忽略规则，并保持重复执行稳定。
• doctor、CLI 帮助与中英文文档同步新规则。

验证

• npm test
• npm run pack:check

Core 3.8.4、CLI 3.6.7，Template 保持 3.8.2。

core-v3.8.3

知识模板 f2s-config-precheck 正文里的 {{FLOW2SPEC_PROJECT_CONFIG}} 占位符改写为不带花括号的写法（zh-CN / en-US 同步）：宿主会对每个 system prompt context 无条件做变量插值，带花括号的占位符会触发变量名校验失败并中断整轮会话。

• Core 3.8.3、Template 3.8.2；CLI 保持 3.6.5，本次仅发布 @double-coding/flow2spec-core
• 兼容范围 ^3.8.2 已覆盖本版本，flow2spec update --core 即可更新
• 本地门禁：version:check / npm test / pack:check 均通过；CI 会重跑全部门禁

cli-v3.6.6

CLI 3.6.6

修复 Windows 下 flow2spec update 永久认为 Core 已是最新（update --core 实际 no-op）的问题。

根因

queryLatestCoreMetadata() 用 npm view <core>@^3.8.2 … 查兼容范围内最新 Core。Windows 下必须 shell: true 才能找到 npm.cmd，而参数只拼接不转义，cmd.exe 把 ^ 当转义符吃掉，查询退化成精确版本 @3.8.2，目标永远等于当前基线。Linux/macOS 与 CI 一直正常，所以此前未暴露。

改法

• 先 npm view <core> versions --json 列全部版本，在 JS 里按 caret 范围过滤取最大
• 再对选中的精确版本查 templateVersion（老版本缺该字段时回落到 Core 版本本身）
• 全程不向 argv 传特殊字符；新增 satisfiesCoreRange()

验证

• Windows 真实 registry 实测：update --check 正确报告 Core: 3.8.3 -> 3.8.3
• Windows 等价回放（复刻 test-cli-update 的 mock）：^3.8.2 → 3.9.0、^0.2.3 → 0.2.4、--core 生效校验通过、任何调用都不含 ^
• CI（Node 18/20/22）跑完整 mock 通过；version:check / pack:check 通过

版本

CLI 3.6.5 → 3.6.6；Core 保持 3.8.3、Template 3.8.2，兼容范围仍 ^3.8.2。

本次仅发布 @double-coding/flow2spec@3.6.6。

core-v3.8.2

Core 3.8.2

• 架构文档命名规则更新
• CLI/Core 兼容范围与独立更新支持
• Template 3.8.1

cli-v3.6.5

CLI 3.6.5

• 使用 Core caret 兼容范围
• flow2spec update --core 支持独立更新 Core
• 同步架构文档命名与升级说明

core-v3.8.1

Highlights

承载 PR #60 主链无二次确认 + Core-only 自动代跑 + kb-sync 反馈简化改造。

版本变化

字段	前	后
Core version	3.8.0	3.8.1
Template version	3.7.0	3.8.0
Protocol	2	2

Template minor bump（新增 skill 行为），Core patch bump 锁步。

主要改动

主链无二次确认

• f2s-req-clarify：澄清落盘后过渡行改推进型措辞（→/继续），落盘后同轮立即调用 f2s-req-tech，禁"是否/正在按X生成"等等待型措辞。
• f2s-req-plan：步骤 2 从"输出草稿并等确认"改为"同轮展示+落盘"；仅当输入含 ≥3 处 TBD / 未指明范围 / 用户明确停步语时才停。
• f2s-implement-tech-design：步骤 3"实现前提问"从必做改为条件触发（默认跳过）。

kb-sync 反馈简化（Issue #38）

• 步骤 2《更新大纲》从 8 大项改为 3 段主体（📥 入库 / 🚫 不入库 / y/n）+ <details> 折叠详情。y/n 门禁不变。

自动更新分场景

• f2s-update-check.js Core-only 分支：Agent 无需征询用户，5 步动作序列（一行前置告知 + flow2spec update --cli fallback npx + 幂等 init + 删缓存 + 一行完成报告）；不进入 f2s-kb-upgrade。
• Template 分支：Agent 转告 + 询问用户 → 同意后代跑 → 走 f2s-kb-upgrade。

下游用户升级路径

• Session 开新对话 → hook f2s-update-check.js 检测到 templateUpdateAvailable=true
• Agent 走 Template 分支：转告 + 询问是否代跑 flow2spec update --cli + flow2spec init <agents>
• 用户同意后代跑；如 projectRev ≠ pkgRev 继续走 f2s-kb-upgrade

PRs

• #60 主链无二次确认 + Core-only 更新自动代跑
• #61 chore(release): core@3.8.1 + cli@3.6.4 + template@3.8.0

后续

CLI 3.6.4 将紧随其后发布（精确 pin Core 3.8.1）。

cli-v3.6.4

Highlights

配套 core-v3.8.1 发布，CLI 精确 pin Core 3.8.1，锁步 patch bump。

版本变化

字段	前	后
CLI version	3.6.3	3.6.4
Core dependency	^3.8.0 → 3.8.0（pin）	3.8.1（pin）

主要改动

无 CLI 自身代码变更；本次为锁步 patch bump 以匹配 Core 3.8.1（含 template 3.8.0）。CLI 精确 pin Core 版本号，Core 一升 CLI 就升。

依赖关系

• @double-coding/flow2spec 3.6.4 → 精确 pin @double-coding/flow2spec-core 3.8.1
• 用户执行 npm i -g @double-coding/flow2spec 会同时拿到最新 Core 与 Template（3.8.0）

用户升级

# 全局升级
npm i -g @double-coding/flow2spec@3.6.4

# 或在业务仓由 Agent 代跑（新版 hook 会自动处理）
flow2spec update --cli
flow2spec init <agents>

相关

• Core release：core-v3.8.1
• PRs：#60（主链改造）、#61（发版承载）