SDD-AI（基于AI的规范驱动开发）以CLI形式打包。

安装 技能 和 子代理，用于 Claude Code、Cursor、OpenCode 和 Codex，引导开发者通过结构化的 AI 辅助开发流程，使用 refacil-sdd/ 作为规范存储库，并设有本地总线，使不同仓库的代理能够相互通信。

---

npm： refacil-sdd-ai |GitHub： Erikole21/refacil-sdd-ai

要求

• Node.js >= 20.0.0
• 一个或多个支持的集成开发环境：Claude Code >= 2.1.89、Cursor、OpenCode 或 Codex

refacil-sdd-ai init 检查 Claude Code 版本，并在低于 2.1.89 时发出警告。在较旧版本中，其余方法论可行，但 compact-bash 无效（仅限 Claude Code——Cursor、OpenCode 和 Codex 有各自的 hook 传递机制）。

---

安装

步骤1 — 全局安装该软件包

步骤2 — 运行init，将技能安装到IDE中

init 安装技能、子代理和钩子到你的IDE的全局用户目录（~/.claude/、~/.cursor/、~/.config/opencode/）。

refacil-sdd-ai

SDD-AI (Specification-Driven Development with AI) packaged as a CLI.

Installs skills and sub-agents for Claude Code, Cursor, OpenCode, and Codex that guide the developer through a structured AI-assisted development workflow, using refacil-sdd/ as the specification store, plus a local bus so agents across different repos can communicate with each other.

---

npm: refacil-sdd-ai | GitHub: Erikole21/refacil-sdd-ai

Requirements

• Node.js >= 20.0.0
• One or more supported IDEs: Claude Code >= 2.1.89, Cursor, OpenCode, or Codex

refacil-sdd-ai init checks the Claude Code version and warns if it is below 2.1.89. With an older version the rest of the methodology works, but compact-bash will have no effect (Claude Code only — Cursor, OpenCode, and Codex have their own hook delivery mechanisms).

---

Installation

Step 1 — Install the package globally

npm install -g refacil-sdd-ai

Step 2 — Run init to install skills into your IDEs

refacil-sdd-ai init

init installs skills, sub-agents, and hooks into your IDE’s global user directories (~/.claude/, ~/.cursor/, ~/.config/opencode/). Skills are available in all your repos from this point — no need to re-run init when you open a new repo.

• Interactive IDE selector (Claude Code / Cursor / OpenCode / Codex) — pre-selects installed IDEs.
  Use --all to install for all four without prompting.
• Your IDE selection is saved to ~/.refacil-sdd-ai/selected-ides.json and reused on every update.
• Also prompts for global branch config (baseBranch, protectedBranches, artifactLanguage)
  stored in ~/.refacil-sdd-ai/config.yaml. Skip with --yes or --defaults.

Re-run init if you install a new IDE or want to change which IDEs have the methodology.

After init, restart your IDE session — new skills are not detected until you restart.

Step 3 — Configure each repo with /refacil:setup

In each repo where you want to use the methodology, open the IDE and run:

/refacil:setup

/refacil:setup:

1. Scaffolds AGENTS.md, .agents/, refacil-sdd/changes/, and project branch configuration (everything the methodology needs for this codebase).
2. Runs refacil-sdd-ai sync-repo-ide from the repository root so per-repo stubs and excludes match your IDE selection from init (~/.refacil-sdd-ai/selected-ides.json): CLAUDE.md, .cursorrules, .claudeignore, .cursorignore, .opencodeignore, plus compact-guidance / testing-policy markers when AGENTS.md / .agents/testing.md exist (same logic as init / update for those files).