用途:在当前项目中部署完整的 SDD 架构,包含 engram 持久化与 ai-context/ 记忆层;也可用交互式向导仅生成项目级 CLAUDE.md。触发方式包括 /project-setup、/project-setup --interactive、/project-setup wizard 等。
主要能力:自动模式(默认)零提问完成部署——检测技术栈,生成根目录 CLAUDE.md、ai-context/ 下 5 个记忆文件(stack.md、architecture.md、conventions.md、known-issues.md、changelog-ai.md)、engram 项目上下文,以及基于检测栈的相关技能注册表。检测依据包括 package.json、pyproject.toml、go.mod、Cargo.toml、pom.xml、Gemfile 等,并推断语言版本、框架、数据库/ORM、测试与构建工具、命名与目录结构约定。
使用方式:自动模式直接运行 /project-setup,依次执行项目检测、生成中立的 AGENTS.md 与一行 CLAUDE.md 导入垫片(内容为 @AGENTS.md)、初始化 ai-context/、通过 mem_save 以 topic_key: project-setup/{project-name} 持久化上下文、输出最终报告。交互模式运行 /project-setup --interactive,仅生成一个 CLAUDE.md,逐题确认,共 5 个问题(技术栈描述、约定、命令、领域术语、覆盖全局规则),写入前预览确认,文件控制在 60 行内,空段落删除。
适用场景:需要为 Claude Code 等工具初始化项目级指令与记忆层的项目;需要跨工具(Copilot、Cursor、Gemini、Codex)共享 AGENTS.md 的项目。
限制:交互模式禁止在 claude-config / agent-config 仓库运行,且不部署 ai-context/;不覆盖已有文件除非用户明确确认;不自动提交或运行审计;engram 不可达时上下文不持久化,SDD 产物为临时性;无法确定的信息标记为 [To confirm];不创建 .claude/commands/ 目录。