Skip to content

🐛 fix(kb): 非主题版本更新直接代跑 init,移除 f2s-kb-migrate (#40) - #44

Merged
Lands-1203 merged 5 commits into
mainfrom
dev_lantao
Aug 24, 2026
Merged

Lands-1203 merged 5 commits into
mainfrom
dev_lantao

Conversation

@Lands-1203

Copy link
Copy Markdown
Collaborator

背景

Closes #40。

需求两条:

  1. 非主题版本更新(.Knowledge/manifest-routing.json 落后 npm latest 但主题层未变)可由 agent 直接代跑 flow2spec init 完成,无需进入 f2s-kb-upgrade 完整流程。
  2. 移除 f2s-kb-migrate skill(历史版本迁移使用,后续不再兼容)。

改动

1. 升级提示改为「直接代跑 init」

  • templates/{zh-CN,en-US}/hooks/f2s-update-check.js:buildNotice 新增 agent-instruction — 转告后可直接执行 flow2spec init <已初始化的 agents> 完成更新;init 后读 .Knowledge/manifest-routing.json,projectRev == pkgRev(非主题更新)即完成并删 .Knowledge/update-check.json;两者不等(含主题层变更)再走 f2s-kb-upgrade 完整流程(从步骤 2c 起,不重复 init)。
  • templates/*/rules/f2s-flow2spec-unified-entry.md 的「知识库版本自检」双保险第 2、3 条同口径更新。
  • packages/core/lib/updateCheck.js 中英 buildNotice 文案更新。

2. 移除 f2s-kb-migrate

  • 删除双根(templates/ + packages/core/templates/)× 双语言(zh-CN + en-US)共 4 处 skill 目录。
  • 下游配置根旧目录由 packages/core/lib/init.js 既有清理逻辑自动删除(模板中不存在的 f2s-* skill 会被 init 移除),无需新增代码。
  • f2s-kb-upgrade SKILL:V1 分支改为「停止本技能 + 告知两条出路」——用历史版本包(@3.4.x 及更早)一次性迁移,或手动迁入 .Knowledge;description、主必控分流、自检项同步改写;新增「非主题版本更新:agent 可直接代跑 init(无需进入本技能)」一节。
  • f2s-intent-routing(删映射行)、f2s-topic-authoring、统一入口的技能列表引用全部清理。

3. 文档 + 知识库同步

  • docs/ zh + en 共 8 份:删除 f2s-kb-migrate 章节与速查表行,upgrade 章节改写为「非主题更新直 init / V1 停技能」新口径。
  • .Knowledge/stock-docs/flow2spec架构说明_终稿.md 流程四同步。
  • KB 新增 topic flow2spec-core-package(含 matcher / manifest / index 路由),沉淀本会话 Q&A 中提炼的 core 包三层职责与消费关系(首次入库)。

4. 版本 bump

  • 3.4.1 → 3.5.0:workspace / core / cli / lockfile / 四处 manifest-routing.json.version。
  • 本次改动含知识库主题层新增(flow2spec-core-package),按 f2s-kb-upgrade 发版纪律需 bump,但 projectRev 已在本仓 f2s-kb-upgrade 完整流程末尾维护,本 PR 不涉及。

5. 项目类型标记

  • 新增 .uniai-project.json 固化仓库为 tech 模式,团队 pull 后 uniai-commit 直接跳过需求关联步骤。

验证

  • npm test 全套通过(kb check ok、topics: 18、routing drift: no、模板 / 初始化 / doctor / tarball 安装测试全绿)。
  • npm run pack:check 通过(double-coding-flow2spec-3.5.0.tgz)。

用户手上待做

  • 合并后建议全局装 latest:npm i -g @double-coding/flow2spec@latest。
  • 本仓 .dsh/ 与根 AGENTS.md 仍是旧 init 产物(含旧 migrate 文案),合入后执行 node ./cli.js init codex claude cursor dsh 一次刷新。

🤖 Generated with Claude Code

Lands-1203 and others added 5 commits August 24, 2026 15:55
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
[摘要] 升级提示改为 agent 直接代跑 flow2spec init,按 projectRev/pkgRev 判定是否再走完整升级;下线旧版迁移技能。

- hook 与统一入口新增 agent-instruction:init 后 projectRev == pkgRev(非主题更新)即完成,不等再走 f2s-kb-upgrade(从步骤 2c 起)
- f2s-kb-upgrade:V1 旧版布局不再内置迁移,命中即停止并告知处理方式(历史版本包一次性迁移 / 手动迁入 .Knowledge)
- 移除 intent-routing / topic-authoring / 统一入口中对 f2s-kb-migrate 的引用(模板目录删除已随配置根分发提交)
- packages/core/lib/updateCheck.js buildNotice 同口径更新

Closes #40

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- workspace / core / cli / manifest 版本 3.4.1 → 3.5.0(含 lockfile 与四处 manifest-routing)
- docs zh/en 各 4 份:删除 f2s-kb-migrate 章节与速查表行,upgrade 章节改写为「非主题更新直 init / V1 停技能」新口径;.Knowledge/stock-docs 终稿同步
- KB 新增 topic flow2spec-core-package(含 matcher / manifest / index 路由),记录 core 包三层职责与 CLI/legacy shim 消费关系

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Lands-1203
Lands-1203 merged commit 1ec706d into main Aug 24, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

代办

1 participant