From 3676e40e745b56d2cb5906a3c37f92b99650c3f4 Mon Sep 17 00:00:00 2001 From: liguochuan <292761894@qq.com> Date: Wed, 19 Aug 2026 14:27:58 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs:=20record=20DeepSeek=20Harn?= =?UTF-8?q?ess=20native=20plugin=20as=20M29?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- ...56\351\207\214\347\250\213\347\242\221.md" | 18 +++++++++++++++++- .Knowledge/topics/f2s-flow2spec-milestones.md | 4 ++-- .Knowledge/topics/flow2spec-dsh-adapter.md | 5 +++-- README.en.md | 4 +++- README.md | 4 +++- README.zh-CN.md | 4 +++- docs/en/milestones.md | 19 +++++++++++++++++-- docs/en/usage-guide.md | 4 ++-- ...77\347\224\250\350\257\264\346\230\216.md" | 4 ++-- ...56\351\207\214\347\250\213\347\242\221.md" | 19 +++++++++++++++++-- packages/cli/README.md | 4 +++- packages/core/lib/dshAgentsAdapter.js | 4 ++-- .../knowledge/topics/flow2spec-dsh-adapter.md | 5 +++-- .../knowledge/topics/flow2spec-dsh-adapter.md | 5 +++-- .../knowledge/topics/flow2spec-dsh-adapter.md | 5 +++-- .../knowledge/topics/flow2spec-dsh-adapter.md | 5 +++-- 16 files changed, 86 insertions(+), 27 deletions(-) diff --git "a/.Knowledge/stock-docs/\351\241\271\347\233\256\351\207\214\347\250\213\347\242\221.md" "b/.Knowledge/stock-docs/\351\241\271\347\233\256\351\207\214\347\250\213\347\242\221.md" index add79e6..00a8069 100644 --- "a/.Knowledge/stock-docs/\351\241\271\347\233\256\351\207\214\347\250\213\347\242\221.md" +++ "b/.Knowledge/stock-docs/\351\241\271\347\233\256\351\207\214\347\250\213\347\242\221.md" @@ -1,12 +1,14 @@ # 项目里程碑 > **范围**：整个项目 -> **更新时间**：`2026-08-04` +> **更新时间**：`2026-08-19` ## 总览 | 阶段 | 时间 | 摘要 | | --- | --- | --- | +| M29 · DeepSeek Harness 原生插件落地 | 2026-08-19 | Core 提供宿主中立资源与版本检查 API；独立仓 [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness) 发布 `@double-coding/flow2spec-deepseek-harness` 原生 Cordis 插件 | +| M28 · DeepSeek Harness 项目级技能适配 | 2026-08-14 | 新增 `flow2spec init dsh`，将 Flow2Spec 技能分发到 `.dsh/skills/`，规则镜像到 `.dsh/topics/`，并适配根 `AGENTS.md` 入口；未装原生插件时仍可用 | | M27 · npm 组织名拼写修正与迁移 | 2026-08-04 | 修正 npm 组织名 codeing → coding，新包发布在 @double-coding/flow2spec 3.2.11；旧包 @double-codeing/flow2spec 3.2.10 收官 + npm deprecate 全版本告知；README/CLI 增加双语迁移公告，f2s-kb-upgrade 步骤 -1 增加 D 分支自动完成组织名迁移（仅存在于旧包收官版） | | M26 · 知识库自动合并引擎与协作边界加固 | 2026-08 | 新增 `flow2spec kb` 五命令、结构化 delta、topic revision 乐观锁与技能自动合并链路；强化 developerId 降级与空 content 校验边界，版本进入 3.2.8 | | M25 · 多人任务按 developerId 隔离 | 2026-07 | 新增协作开关与 developerId 解析链路，将个人任务进度隔离到独立任务根，同时保持共享知识库统一协作 | @@ -35,6 +37,20 @@ | M2 · OpenSpec 退场与 f2s 技能化 | 2026-04-23 | 删除 OpenSpec/opsx 依赖；完整转换为 f2s 自研技能路线；需求澄清、技术方案与技能模板化能力成型 | | M1 · CLI 初始化与 OpenSpec 协作流 | 2026-02 ~ 2026-04 | Flow2Spec 作为可安装 CLI 初始化；早期围绕 OpenSpec/opsx 变更流组织 AI 协作 | +## M29 · DeepSeek Harness 原生插件落地 + +- 独立仓 [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness) 发布原生 Cordis 插件 `@double-coding/flow2spec-deepseek-harness` +- 插件在 Harness 进程内调用 Flow2Spec Core，不复制 CLI、Skills 或知识库算法 +- 通过 Cordis 生命周期加载项目 `.Knowledge/` 与 `f2s-*` 技能；提供 status / init / doctor / route / kb / update 命令与工作区设置卡片 +- Core `3.4.x` 提供 `resources.skillCatalog()`、`resources.unifiedEntry()`、`update.check()`，供原生插件消费 +- `flow2spec init dsh` 作为未安装插件时的项目级兼容入口保留 + +## M28 · DeepSeek Harness 项目级技能适配 + +- 新增 `flow2spec init dsh`：把 Flow2Spec 技能写入 `.dsh/skills//SKILL.md` +- 规则长文镜像到 `.dsh/topics/`，并写入 `.dsh/AGENTS.md` 目录指针 +- 仓库根没有 `AGENTS.md` 时生成 Harness 兼容入口；已有入口不覆盖 + ## M27 · npm 组织名拼写修正与迁移 - 发现旧组织名 `@double-codeing` 存在拼写错误（多了一个 `e`），启动迁移到 `@double-coding` diff --git a/.Knowledge/topics/f2s-flow2spec-milestones.md b/.Knowledge/topics/f2s-flow2spec-milestones.md index 4c02aaf..dcc6e47 100644 --- a/.Knowledge/topics/f2s-flow2spec-milestones.md +++ b/.Knowledge/topics/f2s-flow2spec-milestones.md @@ -1,6 +1,6 @@ --- id: flow2spec-milestones -revision: 0 +revision: 1 summary: flow2spec-milestones primary: feature confidence: inferred @@ -16,7 +16,7 @@ confidence: inferred 当用户询问「项目里程碑」「版本演进」「开源和内部仓区别」「双语 PPT」「Cursor 插件提交」时： -1. 读 [项目里程碑](../stock-docs/项目里程碑.md)：**版本能力表** + M1–M18（最新阶段在前）。 +1. 读 [项目里程碑](../stock-docs/项目里程碑.md)：**版本能力表** + M1–M29（最新阶段在前）。 2. 演示路径：内部 `flow2spec-intro-draft` + `sync-pages.sh`；开源 `flow2spec-intro-public`（中）与 `-public-en`（英）+ `sync-gh-pages.sh`。 3. 架构细节 → `flow2spec架构说明_终稿.md`；演示约定 → `flow2spec-presentations` 主题。 diff --git a/.Knowledge/topics/flow2spec-dsh-adapter.md b/.Knowledge/topics/flow2spec-dsh-adapter.md index cd6085f..6745367 100644 --- a/.Knowledge/topics/flow2spec-dsh-adapter.md +++ b/.Knowledge/topics/flow2spec-dsh-adapter.md @@ -1,6 +1,6 @@ --- id: flow2spec-dsh-adapter -revision: 1 +revision: 2 summary: "DeepSeek Harness 项目级技能初始化与目录适配" primary: feature confidence: inferred @@ -17,7 +17,8 @@ tags: [module] - `flow2spec init dsh` 将 Flow2Spec 技能复制到 `.dsh/skills//SKILL.md`。 - 将模板规则长文镜像到 `.dsh/topics/*.md`，并写入 `.dsh/AGENTS.md` 目录指针。 - 根目录没有 `AGENTS.md` 时生成 Harness 兼容的完整入口；已有入口不会被覆盖。 -- 原生 Cordis 插件不在本适配范围内，属于后续路线图事项。 +- 原生 Cordis 插件已落地：独立仓 [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness)，npm 包 `@double-coding/flow2spec-deepseek-harness`。 +- `flow2spec init dsh` 仍作为未安装原生插件时的项目级兼容入口。 ## 维护边界 diff --git a/README.en.md b/README.en.md index d45ac25..20e0352 100644 --- a/README.en.md +++ b/README.en.md @@ -27,7 +27,9 @@ Flow2Spec adds a spec-driven workflow layer to AI coding agents. It creates a sm ```bash npx @double-coding/flow2spec@latest init -# DeepSeek Harness projects: +# Native DeepSeek Harness plugin: +# https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness +# Project-level adapter without the plugin: flow2spec init dsh ``` diff --git a/README.md b/README.md index f1baa4b..69bea71 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,9 @@ Flow2Spec adds a spec-driven workflow layer to AI coding agents. It creates a sm ```bash npx @double-coding/flow2spec@latest init -# DeepSeek Harness projects: +# Native DeepSeek Harness plugin: +# https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness +# Project-level adapter without the plugin: flow2spec init dsh ``` diff --git a/README.zh-CN.md b/README.zh-CN.md index bcf1854..99a2e66 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -27,7 +27,9 @@ Flow2Spec 是给 AI 编码工具使用的 Spec-driven 工作流层。它会在 ```bash npx @double-coding/flow2spec@latest init -# DeepSeek Harness 项目： +# DeepSeek Harness 原生插件： +# https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness +# 未装插件时的项目级适配： flow2spec init dsh ``` diff --git a/docs/en/milestones.md b/docs/en/milestones.md index 788c5c6..aa9e4ad 100644 --- a/docs/en/milestones.md +++ b/docs/en/milestones.md @@ -3,13 +3,14 @@ # Project Milestones > **Scope**: whole project -> **Updated**: `2026-08-04` +> **Updated**: `2026-08-19` ## Overview | Stage | Time | Summary | | --- | --- | --- | -| M28 · DeepSeek Harness project skill adapter | 2026-08-14 | Added `flow2spec init dsh`, distributing Flow2Spec skills to `.dsh/skills/`, mirroring rules to `.dsh/topics/`, and adapting the repository-root `AGENTS.md` entry; native Cordis plugin work remains on the roadmap | +| M29 · DeepSeek Harness native plugin | 2026-08-19 | Core shipped host-neutral resource and update-check APIs; the [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness) repo published the `@double-coding/flow2spec-deepseek-harness` native Cordis plugin | +| M28 · DeepSeek Harness project skill adapter | 2026-08-14 | Added `flow2spec init dsh`, distributing Flow2Spec skills to `.dsh/skills/`, mirroring rules to `.dsh/topics/`, and adapting the repository-root `AGENTS.md` entry; remains the fallback when the native plugin is not installed | | M27 · npm org rename typo fix & migration | 2026-08-04 | Fixed npm org name typo codeing → coding; new package published as @double-coding/flow2spec 3.2.11; legacy @double-codeing/flow2spec 3.2.10 farewell release + npm deprecate all versions; README/CLI added bilingual migration notice; f2s-kb-upgrade Step -1 added D branch for automatic org rename migration (legacy pkg only) | | M26 · Automated knowledge merge engine and collaboration hardening | 2026-08 | Added five `flow2spec kb` commands, structured deltas, topic-revision optimistic locking, and an automatic skill merge path; tightened developerId fallbacks and blank-content validation; version reached 3.2.8 | | M25 · Per-developer task isolation | 2026-07 | Added collaboration settings and developerId resolution, isolating personal progress under separate task roots while retaining one shared knowledge base | @@ -38,6 +39,20 @@ | M2 · OpenSpec removal and f2s skills | 2026-04-23 | Removed OpenSpec/opsx; converted to f2s skill workflow; requirements clarification and technical proposal generation established | | M1 · CLI bootstrap and OpenSpec workflow | 2026-02 ~ 2026-04 | Flow2Spec started as an installable CLI; early AI collaboration organized around OpenSpec/opsx change flows | +## M29 · DeepSeek Harness Native Plugin + +- Published the native Cordis plugin `@double-coding/flow2spec-deepseek-harness` from [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness) +- The plugin calls Flow2Spec Core inside the Harness process and does not copy the CLI, skills, or knowledge algorithms +- Loads project `.Knowledge/` and `f2s-*` skills through Cordis lifecycle hooks; adds status / init / doctor / route / kb / update commands and a workspace settings card +- Core `3.4.x` added `resources.skillCatalog()`, `resources.unifiedEntry()`, and `update.check()` for native hosts +- `flow2spec init dsh` remains the project-level fallback when the plugin is not installed + +## M28 · DeepSeek Harness Project Skill Adapter + +- Added `flow2spec init dsh` to write Flow2Spec skills to `.dsh/skills//SKILL.md` +- Mirrored long-form rules to `.dsh/topics/` and wrote the `.dsh/AGENTS.md` directory pointer +- Generated a Harness-compatible root `AGENTS.md` only when missing; existing entries are preserved + ## M27 · npm Org Rename Typo Fix & Migration - Discovered a typo in the legacy org name `@double-codeing` (extra `e`); migrated to `@double-coding` diff --git a/docs/en/usage-guide.md b/docs/en/usage-guide.md index 65ec39f..9fb8f53 100644 --- a/docs/en/usage-guide.md +++ b/docs/en/usage-guide.md @@ -30,7 +30,7 @@ Before executing any **`f2s-*` skill**, the Agent needs to obtain the actual val | **Cursor** | `.cursor/rules/f2s-config-check.mdc` (`alwaysApply`) | Config reading remains rule-based: **Read(`flow2spec.config.json`)** before entering skill body. Cursor hooks are used for update checks only, not automatic config reads. | | **Claude Code** | `.claude/hooks/f2s-config-session.js` + `.claude/hooks/f2s-config-inject.js` + `.claude/settings.json` | `SessionStart` injects one config summary; `PreToolUse` only guards **`f2s-*` Skill** calls by reminding the agent that the first skill-body action must be **Read**. Neither replaces the disk read. | | **Codex** | root `AGENTS.md` mandatory step + `.codex/topics/f2s-config-check.md` + `{{FLOW2SPEC_PROJECT_CONFIG}}` field-semantics table + `.codex/hooks/f2s-config-session.js` | `SessionStart` injects one configuration summary; config reading still relies on text rules and **Read** as a hard requirement; the table explains field semantics only, does not write current values, and disk Read is authoritative. Codex has no Claude-style `PreToolUse` guard, so when `subAgent=true` the skill body must explicitly decide whether to split; even when it does not split, it must output the no-split reason. | -| **DeepSeek Harness** | root `AGENTS.md` (generated only when absent) + `.dsh/skills/` + `.dsh/topics/` | Harness loads project instructions from repository-root `AGENTS.md` and discovers project skills from `.dsh/skills//SKILL.md`; Flow2Spec mirrors long-form rules to `.dsh/topics/`. Native Cordis plugin integration is outside this adapter. | +| **DeepSeek Harness** | native plugin `@double-coding/flow2spec-deepseek-harness`; or `flow2spec init dsh` writing root `AGENTS.md` (generated only when absent) + `.dsh/skills/` + `.dsh/topics/` | Prefer the [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness) native Cordis plugin. Without the plugin, Harness loads project instructions from repository-root `AGENTS.md` and discovers project skills from `.dsh/skills//SKILL.md`; Flow2Spec mirrors long-form rules to `.dsh/topics/`. | | **Knowledge Base (optional)** | When `.Knowledge/manifest-routing` hits **`config-precheck`** | `.Knowledge/topics/f2s-config-precheck.md` is a **routing summary** that links to the Codex long-form article; Flow2Spec does **not** maintain a second full copy in `.Knowledge`, nor does it replace a `Read` of the JSON. | For field semantics and default value rules, see [Commands Reference § 6) Sub-Agent Configuration](./commands-reference.md). For the design perspective, see [Design Principles § 4.5.1](./design-principles.md). @@ -138,7 +138,7 @@ In interactive terminals, the Flow2Spec CLI checks the latest npm version with a After `flow2spec init codex`, Codex projects include `.codex/hooks.json`, `.codex/hooks/f2s-config-session.js`, and `.codex/hooks/f2s-update-check.js`. On Codex `SessionStart` for `startup|resume`, the first script injects one configuration summary and the second checks the knowledge-base version automatically. When the hook is first generated or changed, trust it through `/hooks` in Codex. Set `updateCheck.enabled=false` in `flow2spec.config.json` to skip only the version check. -After `flow2spec init dsh`, Flow2Spec writes project skills to `.dsh/skills/`, mirrors long-form rules to `.dsh/topics/`, and writes `.dsh/AGENTS.md` as a directory pointer. If the repository has no root `AGENTS.md`, init generates a Harness-compatible full entry; an existing root file is preserved. +Prefer the native Cordis plugin `@double-coding/flow2spec-deepseek-harness` from [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness). Without the plugin, run `flow2spec init dsh`: Flow2Spec writes project skills to `.dsh/skills/`, mirrors long-form rules to `.dsh/topics/`, and writes `.dsh/AGENTS.md` as a directory pointer. If the repository has no root `AGENTS.md`, init generates a Harness-compatible full entry; an existing root file is preserved. After `flow2spec init cursor`, Cursor projects include `.cursor/hooks.json` and `.cursor/hooks/f2s-update-check.js`. The hook runs on Cursor `sessionStart` and injects upgrade reminders through `additional_context`. Set `updateCheck.enabled=false` in `flow2spec.config.json` to skip the check. diff --git "a/docs/\344\275\277\347\224\250\350\257\264\346\230\216.md" "b/docs/\344\275\277\347\224\250\350\257\264\346\230\216.md" index df6a496..aa95884 100644 --- "a/docs/\344\275\277\347\224\250\350\257\264\346\230\216.md" +++ "b/docs/\344\275\277\347\224\250\350\257\264\346\230\216.md" @@ -39,7 +39,7 @@ flow2spec init [cursor|claude|codex|dsh ...] --reset-knowledge | **Cursor** | `.cursor/rules/f2s-config-check.mdc`（`alwaysApply`） | 配置读取走文本约束：技能正文前先 **Read(`flow2spec.config.json`)**；Cursor hook 仅用于版本更新检测，不自动读取配置。 | | **Claude Code** | `.claude/hooks/f2s-config-session.js` + `.claude/hooks/f2s-config-inject.js` + `.claude/settings.json` | `SessionStart` 仅注入一次配置摘要；`PreToolUse` 仅在调用 **`f2s-*` Skill** 时做守门提示，提醒首步必须 **Read**。两者都不替代磁盘 Read。 | | **Codex** | 根 `AGENTS.md` 顶部强制步骤 + `.codex/topics/f2s-config-check.md` + `{{FLOW2SPEC_PROJECT_CONFIG}}` 字段语义表 + `.codex/hooks/f2s-config-session.js` | `SessionStart` 注入一次配置摘要；配置读取仍以文本约束 + **Read** 为硬要求；表格只说明字段语义，不写当前值，配置真值以磁盘 **Read** 为准。Codex 无 Claude 的 `PreToolUse` 守门，`subAgent=true` 时需在技能正文前段显式判断是否拆子；即使不拆，也必须输出不拆原因。 | -| **DeepSeek Harness** | 根 `AGENTS.md`（缺少时由 init 生成） + `.dsh/skills/` + `.dsh/topics/` | Harness 从仓库根 `AGENTS.md` 加载项目说明，并从 `.dsh/skills//SKILL.md` 发现项目技能；Flow2Spec 将规则长文镜像到 `.dsh/topics/`。本轮适配不包含原生 Cordis 插件。 | +| **DeepSeek Harness** | 原生插件 `@double-coding/flow2spec-deepseek-harness`；或 `flow2spec init dsh` 写入根 `AGENTS.md`（缺少时生成） + `.dsh/skills/` + `.dsh/topics/` | 优先安装 [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness) 原生 Cordis 插件。未装插件时，Harness 从仓库根 `AGENTS.md` 加载项目说明，并从 `.dsh/skills//SKILL.md` 发现项目技能；Flow2Spec 将规则长文镜像到 `.dsh/topics/`。 | | **知识库（可选）** | `.Knowledge/manifest-routing` 命中 **`config-precheck`** 时 | `.Knowledge/topics/f2s-config-precheck.md` 为**路由摘要**，链向 Codex 长文；**不**在 `.Knowledge` 再维护第二份全文，也**不**替代 Read JSON。 | @@ -125,7 +125,7 @@ Flow2Spec CLI 在交互式执行 `flow2spec version` / `flow2spec init` 时会 Codex 项目执行 `flow2spec init codex` 后会写入 `.codex/hooks.json`、`.codex/hooks/f2s-config-session.js` 与 `.codex/hooks/f2s-update-check.js`：前者在 Codex `SessionStart` 的 `startup|resume` 事件注入一次配置摘要，后者自动检查知识库版本；首次生成或 hook 内容变化后，需要在 Codex 中通过 `/hooks` 信任该项目 hook。`flow2spec.config.json` 中 `updateCheck.enabled=false` 时仅跳过版本检查，不影响配置摘要注入。 -DeepSeek Harness 项目执行 `flow2spec init dsh` 后，Flow2Spec 会把项目级技能写入 `.dsh/skills/`，把规则长文镜像到 `.dsh/topics/`，并生成 `.dsh/AGENTS.md` 目录指针。若仓库根没有 `AGENTS.md`，init 会生成一份适配 Harness 的完整入口；若已有该文件则保留用户内容，不覆盖。 +DeepSeek Harness 优先安装原生 Cordis 插件 `@double-coding/flow2spec-deepseek-harness`（独立仓 [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness)）。未装插件时执行 `flow2spec init dsh`：Flow2Spec 会把项目级技能写入 `.dsh/skills/`，把规则长文镜像到 `.dsh/topics/`，并生成 `.dsh/AGENTS.md` 目录指针。若仓库根没有 `AGENTS.md`，init 会生成一份适配 Harness 的完整入口；若已有该文件则保留用户内容，不覆盖。 Cursor 项目执行 `flow2spec init cursor` 后会写入 `.cursor/hooks.json` 与 `.cursor/hooks/f2s-update-check.js`，在 Cursor `sessionStart` 自动检查知识库版本；脚本通过 `additional_context` 把升级提示注入会话。`flow2spec.config.json` 中 `updateCheck.enabled=false` 时跳过检查。 diff --git "a/docs/\351\241\271\347\233\256\351\207\214\347\250\213\347\242\221.md" "b/docs/\351\241\271\347\233\256\351\207\214\347\250\213\347\242\221.md" index c152fa9..9e43f15 100644 --- "a/docs/\351\241\271\347\233\256\351\207\214\347\250\213\347\242\221.md" +++ "b/docs/\351\241\271\347\233\256\351\207\214\347\250\213\347\242\221.md" @@ -3,13 +3,14 @@ # 项目里程碑 > **范围**：整个项目 -> **更新时间**：`2026-08-04` +> **更新时间**：`2026-08-19` ## 总览 | 阶段 | 时间 | 摘要 | | --- | --- | --- | -| M28 · DeepSeek Harness 项目级技能适配 | 2026-08-14 | 新增 `flow2spec init dsh`，将 Flow2Spec 技能分发到 `.dsh/skills/`，规则镜像到 `.dsh/topics/`，并适配根 `AGENTS.md` 入口；原生 Cordis 插件列入后续路线图 | +| M29 · DeepSeek Harness 原生插件落地 | 2026-08-19 | Core 提供宿主中立资源与版本检查 API；独立仓 [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness) 发布 `@double-coding/flow2spec-deepseek-harness` 原生 Cordis 插件 | +| M28 · DeepSeek Harness 项目级技能适配 | 2026-08-14 | 新增 `flow2spec init dsh`，将 Flow2Spec 技能分发到 `.dsh/skills/`，规则镜像到 `.dsh/topics/`，并适配根 `AGENTS.md` 入口；未装原生插件时仍可用 | | M27 · npm 组织名拼写修正与迁移 | 2026-08-04 | 修正 npm 组织名 codeing → coding，新包发布在 @double-coding/flow2spec 3.2.11；旧包 @double-codeing/flow2spec 3.2.10 收官 + npm deprecate 全版本告知；README/CLI 增加双语迁移公告，f2s-kb-upgrade 步骤 -1 增加 D 分支自动完成组织名迁移（仅存在于旧包收官版） | | M26 · 知识库自动合并引擎与协作边界加固 | 2026-08 | 新增 `flow2spec kb` 五命令、结构化 delta、topic revision 乐观锁与技能自动合并链路；强化 developerId 降级与空 content 校验边界，版本进入 3.2.8 | | M25 · 多人任务按 developerId 隔离 | 2026-07 | 新增协作开关与 developerId 解析链路，将个人任务进度隔离到独立任务根，同时保持共享知识库统一协作 | @@ -38,6 +39,20 @@ | M2 · OpenSpec 退场与 f2s 技能化 | 2026-04-23 | 删除 OpenSpec/opsx 依赖；完整转换为 f2s 自研技能路线；需求澄清、技术方案与技能模板化能力成型 | | M1 · CLI 初始化与 OpenSpec 协作流 | 2026-02 ~ 2026-04 | Flow2Spec 作为可安装 CLI 初始化；早期围绕 OpenSpec/opsx 变更流组织 AI 协作 | +## M29 · DeepSeek Harness 原生插件落地 + +- 独立仓 [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness) 发布原生 Cordis 插件 `@double-coding/flow2spec-deepseek-harness` +- 插件在 Harness 进程内调用 Flow2Spec Core，不复制 CLI、Skills 或知识库算法 +- 通过 Cordis 生命周期加载项目 `.Knowledge/` 与 `f2s-*` 技能；提供 status / init / doctor / route / kb / update 命令与工作区设置卡片 +- Core `3.4.x` 提供 `resources.skillCatalog()`、`resources.unifiedEntry()`、`update.check()`，供原生插件消费 +- `flow2spec init dsh` 作为未安装插件时的项目级兼容入口保留 + +## M28 · DeepSeek Harness 项目级技能适配 + +- 新增 `flow2spec init dsh`：把 Flow2Spec 技能写入 `.dsh/skills//SKILL.md` +- 规则长文镜像到 `.dsh/topics/`，并写入 `.dsh/AGENTS.md` 目录指针 +- 仓库根没有 `AGENTS.md` 时生成 Harness 兼容入口；已有入口不覆盖 + ## M27 · npm 组织名拼写修正与迁移 - 发现旧组织名 `@double-codeing` 存在拼写错误（多了一个 `e`），启动迁移到 `@double-coding` diff --git a/packages/cli/README.md b/packages/cli/README.md index f1baa4b..69bea71 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -27,7 +27,9 @@ Flow2Spec adds a spec-driven workflow layer to AI coding agents. It creates a sm ```bash npx @double-coding/flow2spec@latest init -# DeepSeek Harness projects: +# Native DeepSeek Harness plugin: +# https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness +# Project-level adapter without the plugin: flow2spec init dsh ``` diff --git a/packages/core/lib/dshAgentsAdapter.js b/packages/core/lib/dshAgentsAdapter.js index 09388fd..3ebce90 100644 --- a/packages/core/lib/dshAgentsAdapter.js +++ b/packages/core/lib/dshAgentsAdapter.js @@ -26,7 +26,7 @@ function buildDshAgentsMd(templatesDir, projectConfig) { "## Flow2Spec Skills", `## DeepSeek Harness Integration -DeepSeek Harness loads the repository-root \`AGENTS.md\` and discovers project skills from \`./.dsh/skills/\`. Flow2Spec mirrors its long-form rules to \`./.dsh/topics/\` for on-demand reading. Native Cordis plugin integration is outside this initialization adapter.`, +DeepSeek Harness loads the repository-root \`AGENTS.md\` and discovers project skills from \`./.dsh/skills/\`. Flow2Spec mirrors its long-form rules to \`./.dsh/topics/\` for on-demand reading. Prefer the native Cordis plugin \`@double-coding/flow2spec-deepseek-harness\` when installed; \`flow2spec init dsh\` remains the project-level fallback.`, ); return body; } @@ -40,7 +40,7 @@ DeepSeek Harness loads the repository-root \`AGENTS.md\` and discovers project s "## Flow2Spec 技能", `## DeepSeek Harness 适配 -DeepSeek Harness 会加载仓库根 \`AGENTS.md\`，并从 \`./.dsh/skills/\` 发现项目技能。Flow2Spec 将规则长文镜像到 \`./.dsh/topics/\` 供按需读取。原生 Cordis 插件集成不属于本初始化适配范围。`, +DeepSeek Harness 会加载仓库根 \`AGENTS.md\`，并从 \`./.dsh/skills/\` 发现项目技能。Flow2Spec 将规则长文镜像到 \`./.dsh/topics/\` 供按需读取。已安装时优先使用原生 Cordis 插件 \`@double-coding/flow2spec-deepseek-harness\`；\`flow2spec init dsh\` 仍作为项目级兼容入口。`, ); } diff --git a/packages/core/templates/en-US/knowledge/topics/flow2spec-dsh-adapter.md b/packages/core/templates/en-US/knowledge/topics/flow2spec-dsh-adapter.md index 7223d7e..cba0006 100644 --- a/packages/core/templates/en-US/knowledge/topics/flow2spec-dsh-adapter.md +++ b/packages/core/templates/en-US/knowledge/topics/flow2spec-dsh-adapter.md @@ -1,6 +1,6 @@ --- id: flow2spec-dsh-adapter -revision: 0 +revision: 1 summary: "DeepSeek Harness project skill initialization and directory adapter" primary: feature confidence: inferred @@ -13,4 +13,5 @@ Use this topic for `flow2spec init dsh`, DeepSeek Harness skill discovery, `.dsh - Skills are written to `.dsh/skills//SKILL.md`. - Long-form rules are mirrored to `.dsh/topics/*.md`, with `.dsh/AGENTS.md` as a directory pointer. - A missing root `AGENTS.md` receives a full entry; an existing entry is preserved. -- Native Cordis plugin work remains a later roadmap item. +- Native Cordis plugin is available: [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness), npm package `@double-coding/flow2spec-deepseek-harness`. +- `flow2spec init dsh` remains the project-level fallback when the native plugin is not installed. diff --git a/packages/core/templates/zh-CN/knowledge/topics/flow2spec-dsh-adapter.md b/packages/core/templates/zh-CN/knowledge/topics/flow2spec-dsh-adapter.md index b1c0d94..45ef6a4 100644 --- a/packages/core/templates/zh-CN/knowledge/topics/flow2spec-dsh-adapter.md +++ b/packages/core/templates/zh-CN/knowledge/topics/flow2spec-dsh-adapter.md @@ -1,6 +1,6 @@ --- id: flow2spec-dsh-adapter -revision: 0 +revision: 1 summary: "DeepSeek Harness 项目级技能初始化与目录适配" primary: feature confidence: inferred @@ -13,4 +13,5 @@ tags: [module] - 技能写入 `.dsh/skills//SKILL.md`。 - 规则长文镜像到 `.dsh/topics/*.md`，并写入 `.dsh/AGENTS.md` 目录指针。 - 缺少根 `AGENTS.md` 时生成完整入口，已有入口不覆盖。 -- 原生 Cordis 插件属于后续路线图事项。 +- 原生 Cordis 插件已落地：独立仓 [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness)，npm 包 `@double-coding/flow2spec-deepseek-harness`。 +- `flow2spec init dsh` 仍作为未安装原生插件时的项目级兼容入口。 diff --git a/templates/en-US/knowledge/topics/flow2spec-dsh-adapter.md b/templates/en-US/knowledge/topics/flow2spec-dsh-adapter.md index 7223d7e..cba0006 100644 --- a/templates/en-US/knowledge/topics/flow2spec-dsh-adapter.md +++ b/templates/en-US/knowledge/topics/flow2spec-dsh-adapter.md @@ -1,6 +1,6 @@ --- id: flow2spec-dsh-adapter -revision: 0 +revision: 1 summary: "DeepSeek Harness project skill initialization and directory adapter" primary: feature confidence: inferred @@ -13,4 +13,5 @@ Use this topic for `flow2spec init dsh`, DeepSeek Harness skill discovery, `.dsh - Skills are written to `.dsh/skills//SKILL.md`. - Long-form rules are mirrored to `.dsh/topics/*.md`, with `.dsh/AGENTS.md` as a directory pointer. - A missing root `AGENTS.md` receives a full entry; an existing entry is preserved. -- Native Cordis plugin work remains a later roadmap item. +- Native Cordis plugin is available: [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness), npm package `@double-coding/flow2spec-deepseek-harness`. +- `flow2spec init dsh` remains the project-level fallback when the native plugin is not installed. diff --git a/templates/zh-CN/knowledge/topics/flow2spec-dsh-adapter.md b/templates/zh-CN/knowledge/topics/flow2spec-dsh-adapter.md index b1c0d94..45ef6a4 100644 --- a/templates/zh-CN/knowledge/topics/flow2spec-dsh-adapter.md +++ b/templates/zh-CN/knowledge/topics/flow2spec-dsh-adapter.md @@ -1,6 +1,6 @@ --- id: flow2spec-dsh-adapter -revision: 0 +revision: 1 summary: "DeepSeek Harness 项目级技能初始化与目录适配" primary: feature confidence: inferred @@ -13,4 +13,5 @@ tags: [module] - 技能写入 `.dsh/skills//SKILL.md`。 - 规则长文镜像到 `.dsh/topics/*.md`，并写入 `.dsh/AGENTS.md` 目录指针。 - 缺少根 `AGENTS.md` 时生成完整入口，已有入口不覆盖。 -- 原生 Cordis 插件属于后续路线图事项。 +- 原生 Cordis 插件已落地：独立仓 [Flow2Spec-DeepSeek-Harness](https://github.com/double-coding-lab/Flow2Spec-DeepSeek-Harness)，npm 包 `@double-coding/flow2spec-deepseek-harness`。 +- `flow2spec init dsh` 仍作为未安装原生插件时的项目级兼容入口。