跳转至

/project-init

为当前项目创建安全且可审查的 ECC 入门计划。该命令以 dry-run 模式启动，仅在获得明确用户批准后写入文件。

用法

/project-init
/project-init --dry-run
/project-init --target claude
/project-init --target cursor
/project-init --skills continuous-learning-v2,security-review
/project-init --config ecc-install.json

安全规则

  1. 默认使用 dry-run。在用户批准具体计划之前，不修改 CLAUDE.md、配置文件、规则、技能或安装状态。
  2. 保留现有项目指南。如果 CLAUDE.md、.claude/settings.local.json、.cursor/、.codex/、.gemini/、.opencode/、.codebuddy/、.joycode/ 或 .qwen/ 已经存在，检查其内容，并建议合并/追加计划，而不是覆盖。
  3. 使用 ECC 安装程序和清单工具。不要手动复制文件作为安装捷径，也不要克隆任意远程仓库。
  4. 保持权限最小化。生成的配置应与检测到的构建/测试/lint 工具匹配，避免广泛的 shell 访问。
  5. 在应用任何更改之前，准确报告将发生哪些变化。

检测输入

读取当前项目根目录，并从以下内容检测技术栈信号：

  • 包管理器文件：package.json、package-lock.json、pnpm-lock.yaml、yarn.lock、bun.lockb
  • 语言清单：pyproject.toml、requirements.txt、go.mod、Cargo.toml、pom.xml、build.gradle、build.gradle.kts
  • 框架文件：next.config.*、vite.config.*、tailwind.config.*、Dockerfile、docker-compose.yml
  • ECC 配置：ecc-install.json
  • 可选的栈映射：ECC 仓库中的 config/project-stack-mappings.json

如果 ECC 检出可用，将 config/project-stack-mappings.json 用作从技术栈到规则/技能的引用。如果文件不可用，则回退到已安装的 ECC 清单和明确的用户选择。

计划流程

  1. 确定目标 harness。除非用户要求 cursor、codex、gemini、opencode、codebuddy、joycode 或 qwen，否则默认为 claude。
  2. 从项目文件中检测技术栈，并显示每个匹配的证据。
  3. 解析最小且有用的 ECC 计划：
  4. 如果项目中有 ecc-install.json：node scripts/install-plan.js --config ecc-install.json --json
  5. 如果用户指定了 profile：node scripts/install-plan.js --profile <profile> --target <target> --json
  6. 如果用户指定了技能：node scripts/install-plan.js --skills <skill-ids> --target <target> --json
  7. 仅检测到语言技术栈：使用这些语言名称执行旧版语言安装的 dry-run
  8. 在写入前执行 dry-run 应用命令：
node scripts/install-apply.js --target <target> --dry-run --json <language-or-profile-args>
  1. 总结检测到的技术栈、所选模块/组件/技能、目标路径、被跳过的不支持模块以及将被修改的文件。
  2. 在应用非 dry-run 命令之前请求批准。

输出契约

返回内容：

  1. 检测到的技术栈证据
  2. 建议的目标 harness
  3. 使用的确切 dry-run 命令
  4. 批准后执行的确切应用命令
  5. 将创建或修改的文件/目录
  6. 关于现有文件、广泛权限、缺失脚本和不支持目标的警告

CLAUDE.md 指南

如果用户要求 CLAUDE.md 起始文件，则单独生成并保持最小化：

  • 构建命令（如果检测到）
  • 测试命令（如果检测到）
  • lint/类型检查命令（如果检测到）
  • 开发服务器命令（如果检测到）
  • 来自现有包脚本或清单的仓库特定说明

不要在没有显示 diff 并获得批准的情况下替换现有 CLAUDE.md。

  • config/project-stack-mappings.json — 从技术栈到表面的提示
  • scripts/install-plan.js — 确定性计划解析
  • scripts/install-apply.js — dry-run 和应用操作
  • /ecc-guide — 安装前的交互式功能发现

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC