ieookm/agent-to-dsh-migration

agent-to-dsh-migration

把 任意编码 Agent 项目（Claude Code / Codex / Qoder / WorkBuddy 等）迁移到 DeepSeek Harness（dsh） 的完整工具包：一个 dsh skill + 五个零依赖 node 脚本。

面向 CC/Codex 用户：你不用懂 dsh 的插件机制——扫描脚本会自动检测你项目里的 Agent 资产，给你一张预填好“该搬什么、搬进哪个机制、值不值得”的清单，你照着清单走，每一步都有自测命令兜底。
覆盖度：CC 完整适配；Codex 完整适配（AGENTS.md 零迁移、hooks 桥 5/10、skills、config.toml MCP）；Qoder/WorkBuddy 无项目级资产 → 走兜底路径（偏好层 + 脚本零迁移 + 跨脑调用重接线）。

三步上手

0) 前提：本机有 node（CC 本来就要求 node）；dsh 已装（可选——见下）
git clone https://github.com/ieookm/agent-to-dsh-migration.git

1) 还没装 dsh？也能先跑扫描，用 CC 看自己的迁移清单（只读，不改任何东西）
node agent-to-dsh-migration/scripts/scan-cc.mjs /你的/CC项目

2) 把 skill 装进 dsh（用户级，所有工作区可用）
Windows PowerShell:
Copy-Item -Recurse agent-to-dsh-migration "$env:USERPROFILE\.dsh\skills\agent-to-dsh-migration"

3) 在 dsh 里对你的项目说一句：
「把 O:\xxx 这个 CC 项目迁移到 dsh」
→ agent 会自动载入本 skill，按流程执行：清单 → 预设 → 指令 → skills → 插件 → MCP → 自测

安装后 dsh 的 skill 目录会实时收录（无需重启）。卸载 = 删掉 ~/.dsh/skills/agent-to-dsh-migration/。

仓库结构

SKILL.md                     # dsh skill：流程 + 决策表 + 产品对照表 + 踩坑清单 + 自测配方
scripts/
scan-agent.mjs             # 只读扫描，自动检测 claude/codex/qoder 资产 → 预填机制推荐的迁移清单
gen-mcp-rows.mjs           # MCP → dsh 预设行：--from claude(.mcp.json) / --from codex(config.toml)
check-skill-frontmatter.mjs# skills 目录与 dsh-skill-filesystem 兼容性检查（.claude/.codex 通用）
gen-preset.mjs             # 生成 standard 全量预设骨架（可立即自测）
scan-cc.mjs                # scan-agent.mjs 的兼容别名
references/
case-study.md              # 真实案例：双工作区完整迁移记录（决策 + 坑位修复 + 成品插件范本）

四个脚本全部零依赖（Node ≥ 18 直接跑，不用 npm install）。

覆盖什么

| CC 资产 | 迁移方式 |
|---|---|
| CLAUDE.md / AGENTS.md | dsh 原生读（两者都注入）；生成镜像型 AGENTS.md 换第三文件 |
| skills（.claude/skills/） | 预设 customSkillDirs 直接指过去，零拷贝（archived/ 自动排除） |
| hooks（8 类 30 事件） | 桥支持 7/30 且每条有已知限制；bespoke 语义（G0 闸门等）→ 原生插件 |
| .mcp.json | 一 server 一行，工具名 mcp____ 与 CC 同形 |
| memory/ 知识库 | section + 检索工具（不是 skill） |
| auto memory 偏好层 | 提炼进 $DSH_HOME/AGENTS.md（用户级全局注入） |
| scripts/* | 零迁移，直接跑 |

FAQ

为什么是 skill + 脚本，不是插件包？ 迁移是低频一次性操作；skill 拷贝即装、脚本 clone 即跑，没有 npm 构建/发布/安装门槛。插件化留给“常驻能力”。

hooks 能不能直接挂桥？ 能，但桥对 PreToolUse 的 additionalContext/updatedInput 被忽略、SessionStart 只吃 JSON 输出、Stop 无 block 上限——先跑 scan-cc 看每条 hook 的实测备注再决定。

脚本会改我的 CC 项目吗？ 不会。全部只读；产物只落在 /.dsh/ 和 ~/.dsh/。

License

MIT