@xt-ws/ai-sdd-workspaces

把 OpenSpec 的四步工作流包装成 agent 指令，一条命令落地到 CodeBuddy 与 Claude Code。

生成物是纯 Markdown：每个步骤一个 skill（xt-ai-sdd-<step>）和一个 斜杠命令（/xt-ai-sdd:<step>），外加一份写进 AGENTS.md / CLAUDE.md 的导航区块。agent 读导航就知道该走哪条指令，不需要你解释流程。

使用

# 在目标项目里初始化
npx @xt-ws/ai-sdd-workspaces init

# 或全局安装后用短命令
npm i -g @xt-ws/ai-sdd-workspaces
xt-ai-sdd init

初始化完成后，在项目里让 agent 执行：

| 步骤 | 指令 | 作用 | | --- | --- | --- | | 1 | /xt-ai-sdd:explore <主题> | 只读调研，输出问题 / 方案 / 开放问题 | | 2 | /xt-ai-sdd:propose <名字或描述> | 产出 change 提案：proposal → specs → design → tasks | | 3 | /xt-ai-sdd:apply <change 名> | 按 tasks 逐条实现代码 | | 4 | /xt-ai-sdd:archive <change 名> | 归档 change，把 spec delta 合并回主规格 |

约束由 skill 自身保证：propose 阶段不碰业务代码，apply 阶段不碰提案文档。

常用选项

xt-ai-sdd init [选项]

  --tools <ids>       目标 harness，逗号分隔（codebuddy,claude）。默认两个都生成
  --path <dir>        目标项目目录。默认当前目录
  --yes               对所有提问回答 yes（含全局安装 openspec）
  --no-interactive    从不提问，直接降级为 npx 方式
  --force             覆盖已存在的文件
  --dry-run           只预览将要写入的文件，不落盘

--dry-run 会逐文件列出 create / update / overwrite / skip，并对将被覆盖的文件给出警告，用来在执行前确认影响面。

前提

需要 openspec。已全局安装就直接用；没有的话，交互式执行会询问是否全局安装，非交互（--no-interactive）下自动降级为 npx 方式调用。旧版 openspec 不认识 --no-animation 时会自动退回最小参数集。

生成物

.codebuddy/skills/xt-ai-sdd-{explore,propose,apply,archive}/SKILL.md
.codebuddy/commands/xt-ai-sdd/{explore,propose,apply,archive}.md
.claude/…                     （--tools claude，同上结构）
AGENTS.md / CLAUDE.md         锚点区块，重复初始化只原地更新
.xt-ai-sdd/config.json        记录 generator / harness / runner
openspec/                     由 openspec init 创建

导航文件用 <!-- xt-ai-sdd:begin --> / <!-- xt-ai-sdd:end --> 锚点包裹，你在锚点外写的内容不会被覆盖。

升级提示

0.3.0 起命令命名空间统一为 xt-ai-sdd：可执行文件名是 xt-ai-sdd（不再提供 ai-sdd），斜杠命令是 /xt-ai-sdd:*（不再提供 /opsx:*）。

从旧版升级后，若项目里残留 <harness>/commands/opsx/ 目录，init 会检测到并给出清理命令，不会自动删除。