640‑skills – 面向 AI 编码代理的 SBTD 工作流

它是什么

• 一组 技能（配置模块），为 AI 驱动的代码生成代理（如 Codex、Oh My Pi (OMP)、Claude Code 和 Kimi）实现 SBTD（规范‑行为‑测试‑领域）工作流。
• 该仓库不包含可运行的应用程序；它提供 Onboard 技能、14 个捆绑技能的目录，以及 19 个外部技能的引用，共同使工作流可复现。

核心理念

• 连接项目的规范、行为规则、测试和领域语言，使 AI 编码代理能够自主行动，同时人类对范围、权限和验证保持明确控制。
• 所有操作均以代理解释的自然语言提示词表达；仓库提供提示词模板和底层技能定义。

关键组件

组件	作用
sbtd-workflow-onboard	引导技能，安装目录其余部分、验证环境，并为每个项目创建 AGENTS.md 文件。
捆绑技能（14 个）	核心 SBTD 步骤（例如，规范摄入、测试生成、规则执行、证据收集）。
外部技能（19 个）	工作流依赖的必需第三方技能；仓库列出其标识符和版本固定。
skills CLI 集成	使用 Vercel‑labs Skills 命令行工具为给定代理（例如 codex、omp）添加、列出和管理技能。
参考文档（REFERENCE.md）	详细的命令行语法、两种执行模式（全局 vs. 仅项目），以及每个工作流操作（初始化、升级、重置、迁移、清理、恢复）的确切提示词。

安装流程

1. 引导 Onboard 技能 – 将提供的自然语言指令粘贴到编码代理中，或运行官方 Skills CLI：

   npx --yes skills@latest add https://github.com/KunoLu/640-skills \
     --skill sbtd-workflow-onboard --global --agent codex --yes --copy
   

2. 检查安装目录 – 确认 Python 版本（≥3.10），并运行 pip install -r <path>/requirements.txt 以满足技能的 Python 依赖。
3. 初始化项目 – 使用 init 或 init-projects 提示词（见 README）为一个或多个绝对项目路径安装 AGENTS.md 和任何必需的全局技能。
4. 后续操作（升级、重置、迁移、清理、恢复）均由代理执行的提示词模板驱动；README 为每种场景提供可直接复制的文本。

典型用法

• 首次设置 – 复制 bootstrap 提示词，让代理验证标签（v2.0.1），然后运行 init 提示词以全局安装所有技能并创建每个项目的配置。
• 添加新项目 – 使用目标平台（codex 或 omp）运行 init-projects 提示词，仅影响指定项目，不触碰全局技能安装。
• 升级 – 调用 upgrade 提示词生成计划、审查 JSON 计划、批准，然后应用。工作流将规划、应用和验证阶段分开。
• 从 SBTD v1 迁移 – 一组专用提示词指导安全迁移，在明确批准前保持遗留数据分离。
• 清理与恢复 – 存在用于规划遗留资产清理或恢复先前批准的更改批次的提示词。

为什么重要

• 为让基于 LLM 的编码代理修改代码库提供正式、基于证据的流程，减少意外覆盖。
• 使每个操作的范围明确（全局 vs. 仅项目、备份策略、权限检查），这对需要可审计性的团队至关重要。
• 通过 Skills 框架抽象底层 CLI，适用于多个宿主代理（Codex、OMP、Claude Code、Kimi）。

更多信息

• 发布说明：v2.0.1 标签和变更日志（英文和中文）。
• 详细命令参考：sbtd-workflow-onboard/REFERENCE.md。
• 设计与验收标准：docs/prd/...。

---

以上所有信息均直接取自仓库的 README；未推断任何额外功能。