Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .Knowledge/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@
| flow2spec-doctor | `.Knowledge/topics/flow2spec-doctor.md` | `flow2spec doctor` 只读检查环境、项目初始化、协作上下文与知识库健康 | stock:[Doctor 诊断命令](stock-docs/Flow2Spec-doctor诊断命令.md);中英文命令文档:`docs/命令说明.md` / `docs/en/commands-reference.md` |
| flow2spec-dsh-adapter | `.Knowledge/topics/flow2spec-dsh-adapter.md` | `flow2spec init dsh`、DeepSeek Harness 项目技能发现与 `.dsh/` 目录适配 | 用户文档:`docs/使用说明.md` / `docs/en/usage-guide.md`;实现:`lib/dshAgentsAdapter.js` |
| flow2spec-core-package | `.Knowledge/topics/flow2spec-core-package.md` | `@double-coding/flow2spec-core` 职责边界:核心实现、发包模板真源、原生插件 API 与 CLI/legacy shim 消费关系 | 开发者文档:`packages/core/README.md`;入口:`packages/core/index.js` |
| flow2spec-qoder-plugin | `.Knowledge/topics/flow2spec-qoder-plugin.md` | Qoder 插件构建、`build:qoder-plugin`、zip 打包与插件市场分发 | 构建脚本:`scripts/build-qoder-plugin.js`;内容源:`packages/core/index.js`(resources API) |

每主题保留 **1–3 条** 可点击摘要链接;全量路径对照写入 `.Knowledge/migration-report.md`(迁移场景)。
其中 **`implement-tech-design`**、**`f2s-doc-routing`**、**`config-precheck`**、**`f2s-task`** 在 `topics/` 内为**路由摘要**;执行长文见配置根 **`rules/f2s-*.md(c)`**;使用 Codex 时见 **`.codex/AGENTS.md`**、**`.codex/topics/f2s-*.md`**(`f2s-config-check` 与 `AGENTS` 前置同源,按需打开)。**`f2s-knowledge-preflight`** 与 **`f2s-kb-feedback-closing`** 是普通问答首读 / 源码补答收口门禁,作为配置根规则 / Codex 专题长文生效,不写入 `topicPaths` 或 `taskToTopicRules`;**`f2s-kb-feedback-closing`** 在 cases 1–3 建议执行 **`f2s-kb-distill`**。
Expand Down
18 changes: 17 additions & 1 deletion .Knowledge/manifest-routing.json
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,8 @@
"flow2spec-init-defaults": ".Knowledge/topics/f2s-init-defaults.md",
"flow2spec-collaboration": ".Knowledge/topics/flow2spec-collaboration.md",
"flow2spec-doctor": ".Knowledge/topics/flow2spec-doctor.md",
"flow2spec-core-package": ".Knowledge/topics/flow2spec-core-package.md"
"flow2spec-core-package": ".Knowledge/topics/flow2spec-core-package.md",
"flow2spec-qoder-plugin": ".Knowledge/topics/flow2spec-qoder-plugin.md"
},
"taskToTopicRules": [
{
Expand Down Expand Up @@ -172,6 +173,14 @@
"topics": [
"flow2spec-core-package"
]
},
{
"task": "flow2spec-qoder-plugin",
"matcherId": "m-flow2spec-qoder-plugin",
"matcherPath": ".Knowledge/matchers/m-flow2spec-qoder-plugin.json",
"topics": [
"flow2spec-qoder-plugin"
]
}
],
"projectRev": 2,
Expand Down Expand Up @@ -263,6 +272,13 @@
"flow2spec-core-package": {
"primary": "module",
"confidence": "inferred"
},
"flow2spec-qoder-plugin": {
"primary": "feature",
"confidence": "inferred",
"tags": [
"module"
]
}
}
}
14 changes: 14 additions & 0 deletions .Knowledge/matchers/m-flow2spec-qoder-plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"includeAny": [
"Qoder 插件",
"qoder plugin",
"qoder-plugin",
"插件构建",
"build:qoder-plugin",
"插件打包",
"插件市场"
],
"id": "m-flow2spec-qoder-plugin",
"version": "1.0.0",
"schema": "flow2spec.matcher.v1"
}
32 changes: 32 additions & 0 deletions .Knowledge/topics/flow2spec-qoder-plugin.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
id: flow2spec-qoder-plugin
revision: 1
summary: "Qoder 原生插件构建:从 Core 全量生成 skills/rules/hooks 并打包 zip"
primary: feature
confidence: inferred
tags: [module]
---
# Qoder 插件构建与分发

## 适用场景

用于 Qoder 插件构建、`npm run build:qoder-plugin`、`output/qoder-plugin/` 产物、插件 zip 打包与插件市场分发问题。

## 已落地能力

- `scripts/build-qoder-plugin.js` 通过 `@double-coding/flow2spec-core` 的 `resources` 公共 API(`skillCatalog` / `listRules` / `listHooks` / `read` / `getVersions`)全量生成 Qoder 原生插件:18 skills + 10 rules + 3 hooks + `.qoder-plugin/plugin.json` + README + logo。
- 采用 dsh host 适配生成内容:技能名 kebab-case(如 `f2s-kb-addRules` → `f2s-kb-add-rules`,满足 Qoder 市场命名规范),路径统一为插件根相对的 `rules/`、`skills/`,与 Qoder 插件目录布局一致。
- hooks 占位符(`__FLOW2SPEC_*__`)按 `init` 同款规则以 Core / Template Version 渲染;`hooks/hooks.json` 用 `${QODER_PLUGIN_ROOT}` 定位脚本(SessionStart 配置摘要 + 版本检查,PreToolUse matcher `Skill` 配置兜底注入)。
- 零依赖 ZIP 打包(Node 内置 `zlib` + 脚本内 ZIP 格式实现):产出 `output/qoder-plugin/flow2spec-<coreVersion>.zip`,zip 根即插件根(直接包含 `.qoder-plugin/plugin.json`),满足市场上传要求。
- 插件版本跟随 Core Version;`--locale en-US` 可生成英文版。

## 维护边界

- 构建脚本:`scripts/build-qoder-plugin.js`(npm script `build:qoder-plugin`)
- 内容事实源:`packages/core/index.js` 的 `resources` API 与 `packages/core/templates/`(包边界与版本契约见 `flow2spec-core-package` 主题)
- 产物目录:`output/qoder-plugin/`(已 gitignore;每次构建先清空重建)
- 插件使用前提:目标项目须先 `npx @double-coding/flow2spec init` 生成 `.Knowledge/` 与 `flow2spec.config.json`

## 禁止项

- 手工编辑 `output/qoder-plugin/` 下产物(下次构建会整体覆盖);内容修正应改 `packages/core/templates/` 或构建脚本后重跑构建。
Loading