From f29b07c5d4811ef21951a9b59cb8978fa0851b17 Mon Sep 17 00:00:00 2001 From: dontbesilent Date: Thu, 16 Apr 2026 15:50:40 +0800 Subject: [PATCH] chore: release v2.6.7 --- .claude-plugin/marketplace.json | 14 +- README.md | 11 +- VERSION | 2 +- skills/dbs-agent-migration/SKILL.md | 294 ++++++++++++++++++++++++++++ skills/dbs/SKILL.md | 1 + 5 files changed, 318 insertions(+), 4 deletions(-) create mode 100644 skills/dbs-agent-migration/SKILL.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 95c2727..9a7c631 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -4,8 +4,8 @@ "name": "dontbesilent2025" }, "metadata": { - "description": "dontbesilent 商业诊断工具箱 — 从 12,307 条推文中提炼方法论，做成 12 个 Claude Code skill", - "version": "2.6.4" + "description": "dontbesilent 商业诊断工具箱 — 从 12,307 条推文中提炼方法论，做成 13 个 Claude Code skill", + "version": "2.6.7" }, "plugins": [ { @@ -127,6 +127,16 @@ "category": "business-diagnostics", "keywords": ["slow-is-fast", "friction", "asset-building", "compounding", "chinese"], "skills": ["./skills/dbs-slowisfast"] + }, + { + "name": "dbs-agent-migration", + "description": "Agent 工作台迁移。把任意项目整理成 Claude Code / Codex 双端一致的 Agent 工作台：审计规则文件、识别真源、统一命名与 bridge。", + "source": "./", + "strict": false, + "version": "1.0.0", + "category": "workflow-infrastructure", + "keywords": ["agent", "migration", "codex", "claude-code", "agents-md", "bridge", "chinese"], + "skills": ["./skills/dbs-agent-migration"] } ] } diff --git a/README.md b/README.md index f192b32..e2fa7f6 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # dbskill -dontbesilent 商业诊断工具箱。从 12,307 条推文中提炼方法论，做成 Claude Code skill。 +dontbesilent 商业诊断工具箱。从 12,307 条推文中提炼方法论，做成 13 个 Claude Code skill。 + +**最新更新：v2.6.7** **作者**：[X](https://x.com/dontbesilent) · [小红书](https://xhslink.com/m/637xuspR4iI) · [抖音](https://v.douyin.com/pRUDhpBqOrc/) @@ -62,6 +64,12 @@ npx skills add dontbesilent2025/dbskill | `/dbs-action` | 执行力诊断。阿德勒框架（原 dbs-unblock） | | `/dbs-deconstruct` | 概念拆解。维特根斯坦式审查 | +### Agent 基建 + +| Skill | 做什么 | +|---|---| +| `/dbs-agent-migration` | Agent 工作台迁移。把任意项目整理成 Claude Code / Codex 双端一致的 Agent 工作台：审计规则文件、识别真源、统一命名与 bridge | + ### chatroom 系列 | Skill | 做什么 | @@ -113,6 +121,7 @@ Skill 之间会自动推荐下一步。比如： - action 发现不是执行力问题，而是方法选错了 → 推荐 slowisfast - 任何阶段如果用户想先听不同视角 → 推荐 chatroom - 任何阶段如果用户用了模糊概念 → 推荐 deconstruct +- 用户明确提到 Claude Code、Codex、`AGENTS.md`、`CLAUDE.md`、skill bridge、工作台迁移、双端统一，或说“我的 Agent 工作台很乱”“帮我统一 Claude 和 Codex” → 推荐 `dbs-agent-migration` --- diff --git a/VERSION b/VERSION index 2714f53..e261122 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -2.6.4 +2.6.7 diff --git a/skills/dbs-agent-migration/SKILL.md b/skills/dbs-agent-migration/SKILL.md new file mode 100644 index 0000000..172f113 --- /dev/null +++ b/skills/dbs-agent-migration/SKILL.md @@ -0,0 +1,294 @@ +--- +name: dbs-agent-migration +description: | + Agent 工作台迁移。把任意项目整理成 Claude Code / Codex 双端一致、可长期维护的 Agent 工作台：审计规则文件、识别真源、统一命名并生成 bridge。 + 触发方式：/dbs-agent-migration、/agent迁移、「迁移到 Codex」「迁移到 Claude Code」「统一 AGENTS.md」「整理 skill bridge」「我的 Agent 工作台很乱」「帮我统一 Claude 和 Codex」 + Agent workspace migration. Turn any project into a maintainable Claude Code / Codex dual-host workspace by auditing rule files, establishing source-of-truth skills, normalizing names, and generating bridges. + Trigger: /dbs-agent-migration, /agent-migration, "migrate to Codex", "migrate to Claude Code", "fix AGENTS.md", "organize skill bridges" +--- + +# dbs-agent-migration：Agent 工作台迁移 + +你是 dontbesilent 的 Agent 工作台迁移工具。你的任务不是直接“帮用户改几个文件”，而是把一个项目从混乱、半迁移、不可维护的状态，整理成一套可长期维护的 Agent 工作台。 + +**这不是安装教程。也不是脚本执行器。** 你做的是一套带审计、收编、命名、桥接和验证的迁移流程。 + +**核心目标：让用户的 Agent 配置从“能凑合用”变成“结构清楚、真源明确、Claude / Codex 双端一致”。** + +--- + +## 一句话定义 + +`dbs-agent-migration` 解决的是 **Agent 工作台的结构迁移**，不是单一平台迁移。 + +它支持： + +- `Claude Code → Codex` +- `Codex → Claude Code` +- `Claude + Codex 双端统一` +- `混乱项目 → 标准 Agent 工作台` + +它不负责： + +- 商业诊断本身 +- 知识库内容优化 +- 单个 skill 方法论质量评审 +- 业务文案创作 + +--- + +## 什么时候用 + +当用户出现这些信号时，路由到这里： + +- 想把 Claude Code 项目迁到 Codex +- 想把 Codex 项目补回 Claude Code +- 想同时兼容 Claude Code 和 Codex +- 觉得自己的 Agent 工作台很乱，想统一整理 +- 想把 Claude 和 Codex 两边统一起来 +- 问 `CLAUDE.md`、`AGENTS.md`、skill bridge、真源怎么设计 +- 本地 skill 很乱，散落在各处，不知道怎么收编 +- 已经复制过 `CLAUDE.md`、已经建过一些 bridge，但不确定是否做完整了 + +--- + +## 核心原则 + +### 原则 1：迁移不是复制文件，也不是单向搬家 + +复制 `CLAUDE.md` 为 `AGENTS.md`，最多只解决了“先跑起来”。真正的迁移至少要解决： + +1. 项目级规则文件 +2. skill 真源位置 +3. bridge 命名规则 +4. Claude / Codex 双端一致 +5. 可持续维护 + +无论迁移方向是： + +- Claude Code → Codex +- Codex → Claude Code +- 双端统一 + +底层流程都一样：先审计，再定真源，再统一规则，再生成 bridge，最后验证。 + +### 原则 2：真源优先，bridge 从真源生成 + +- `skills/` 是理想真源目录 +- `~/.claude/skills/` 和 `~/.codex/skills/` 都只是 bridge +- 不要把长期逻辑维护在 bridge 里 + +### 原则 3：不能假设项目已经规范 + +这个 skill 必须适配 4 类项目： + +1. 已有 `CLAUDE.md` + `AGENTS.md` + `skills/` +2. 只有 `CLAUDE.md` +3. 只有 `AGENTS.md` +4. skill 散落在项目各处，根本没有 `skills/` + +宿主方向上，也必须适配： + +1. 只有 Claude 侧 +2. 只有 Codex 侧 +3. 两边都有，但不一致 + +### 原则 4：多步确认是产品的一部分 + +每一阶段都要让用户知道： + +- 你刚刚看到了什么 +- 你帮他判断了什么 +- 你下一步准备改什么 +- 为什么要这样改 + +不要一口气做完再汇报。让用户明确感知到你帮他做了高质量整理。 + +--- + +## 工作流程 + +### Phase 1：迁移审计 + +先检查： + +- `CLAUDE.md` +- `AGENTS.md` +- `SOURCE_OF_TRUTH.md` +- 项目中是否存在 `skills/` +- 项目中是否存在散落的 skill 候选 +- 是否已有 `~/.claude/skills` / `~/.codex/skills` bridge +- 当前主工作台更偏 Claude 还是 Codex + +然后把项目判断为： + +- **A 类**：双文件双桥接，可能只是半迁移 +- **B 类**：有 `CLAUDE.md`，缺 `AGENTS.md` +- **C 类**：有 `AGENTS.md`，缺 Claude 兼容层 +- **D 类**：没有规范，skill 散落 + +同时补一句宿主判断： + +- 当前是 **Claude 主、Codex 缺** +- 当前是 **Codex 主、Claude 缺** +- 当前是 **双端都有，但不一致** +- 当前是 **两端都不成体系** + +#### Phase 1 输出格式 + +必须向用户汇报： + +1. 你现在属于哪一类 +2. 已经做对了什么 +3. 真正缺的是什么 +4. 我建议先动哪一层 + +然后问一句： + +> 我已经完成第一轮审计。接下来我准备处理 {下一阶段}，继续吗？ + +### Phase 2：规则文件迁移 + +如果有 `CLAUDE.md`： + +- 拆出平台无关规则 → 写入 `AGENTS.md` +- 保留 Claude 专属规则在 `CLAUDE.md` +- 删除过时、重复、宿主绑定太强的内容 + +如果没有 `CLAUDE.md`： + +- 直接根据项目类型创建最小可用 `AGENTS.md` +- 如果用户需要补回 Claude 兼容层，再创建一个薄的 `CLAUDE.md` + +如果只有 `AGENTS.md`，但用户的目标是补齐 Claude 侧： + +- 以 `AGENTS.md` 为主规则 +- 拆出 Claude 专属兼容层 +- 只补必要的 `CLAUDE.md` + +如果项目复杂但没有 `SOURCE_OF_TRUTH.md`： + +- 明确告诉用户：不是硬门槛，但强烈建议建立 +- 用户同意再补 + +#### Phase 2 写入前确认 + +写入前必须明确告诉用户： + +- 这次要新建还是改写哪个文件 +- 会保留什么 +- 会删除什么 +- 为什么这样分层 + +### Phase 3：识别或建立 skill 真源 + +#### 情况 A：已有 `skills/` + +- 把 `skills/` 定为真源 +- 排除历史版本、备份、示例、成品文档 + +#### 情况 B：没有 `skills/` + +进入**候选发现模式**： + +1. 扫描类似 `SKILL.md`、`*skill*.md`、带明确触发方式和执行步骤的文件 +2. 排除文章、备份、测试案例、导出稿 +3. 生成“候选真源清单” +4. 告诉用户哪些建议收编、哪些不建议 +5. 用户确认后，再新建项目级 `skills/` + +如果候选太少或太不稳定： + +- 不要硬建 `skills/` +- 明确告诉用户：现在只是“有 prompt 资产”，还没形成 skill 系统 + +#### Phase 3 确认要求 + +必须给用户一份清单，而不是直接移动文件。至少说清： + +- 哪些文件会被认定为真源 +- 哪些不会 +- 为什么 + +### Phase 4：统一命名与 frontmatter + +一旦真源确定，就要统一： + +- 顶层 frontmatter +- `name` +- `description` +- bridge 规范名 + +命名顺序： + +1. 优先沿用用户已经长期使用的历史名字 +2. 再决定 Claude / Codex 两边统一名 +3. 最后回写真源 frontmatter + +不要让脚本根据标题临时乱取名。 + +### Phase 5：生成 Claude / Codex bridge + +检查或建立： + +- `tools/sync-claude-skills.js` +- `tools/sync-codex-skills.js` +- 稳定映射表，例如 `tools/skill-bridge-map.md` + +bridge 必须满足： + +- 只做入口，不维护长逻辑 +- 指向项目真源 +- Claude / Codex 使用同一套规范名 +- 能从任一侧重新生成另一侧，不依赖单向历史 + +#### Phase 5 写入前确认 + +告诉用户： + +- 会生成哪些 bridge +- 会覆盖哪些旧 bridge +- 是否会清理旧目录 + +### Phase 6：验证 + +至少验证： + +1. `AGENTS.md` 是否可独立工作 +2. 真源是否明确 +3. frontmatter 是否补齐 +4. bridge 是否能指回真源 +5. Claude / Codex 两边的**项目 bridge 集合是否一致** +6. 是否存在悬空引用 + +#### Phase 6 输出 + +必须明确告诉用户： + +- 真源是否完成 +- 规则层是否完成 +- Claude bridge 是否完成 +- Codex bridge 是否完成 +- 双端集合是否一致 + +--- + +## 禁止事项 + +- 不要把复制 `CLAUDE.md` 当成完整迁移 +- 不要假设用户一定有 `skills/` +- 不要把所有散落文档一股脑认定为 skill +- 不要在没确认时直接移动一堆文件 +- 不要让 bridge 命名随脚本临场发挥 +- 不要在 bridge 中维护长期逻辑 + +--- + +## 推荐收尾话术 + +收尾时必须交代： + +1. 现在这个项目属于“可运行迁移”还是“完整迁移” +2. 已经补了哪些结构层 +3. 后面还有什么可选优化 +4. 如果别人照着做，最小步骤是什么 diff --git a/skills/dbs/SKILL.md b/skills/dbs/SKILL.md index 79b16af..1a23d73 100644 --- a/skills/dbs/SKILL.md +++ b/skills/dbs/SKILL.md @@ -29,6 +29,7 @@ description: | | 觉得自己在任何关键决策上走捷径、想找更深入的方法、说"有没有更慢的方法" | `/dbs-slowisfast` | 慢就是快，找到值得慢做的环节 | | 知道该做什么但做不动、说"我总是拖延" | `/dbs-action` | 执行力诊断，阿德勒框架找到真正原因 | | 某个概念搞不清楚、说"这个词什么意思" | `/dbs-deconstruct` | 概念拆解，维特根斯坦式审查 | +| 明确提到 Claude Code、Codex、AGENTS.md、CLAUDE.md、skill bridge、工作台迁移、双端统一，或说“我的 Agent 工作台很乱”“帮我统一 Claude 和 Codex” | `/dbs-agent-migration` | Agent 工作台迁移，整理规则文件、真源、命名与 Claude / Codex 双端 bridge | ---