SuperAPI AI 工具集

project-setup

编程与开发

查看项目

更新于 10-16 04:08

技能介绍

用途

Project Setup 用于项目配置初始化,典型使用场景包括:首次搭建项目、自动检测框架、替换 CLAUDE.md 中的占位符。它通过读取项目清单文件推断项目环境,并据此生成或补全 .claude/CLAUDE.md 配置。

主要能力

该技能按阶段执行以下工作:

  • Phase 1 检测项目环境:按顺序检测生态系统(通过 glob 查找 package.json、pyproject.toml、Cargo.toml、go.mod、build.gradle、pom.xml、Gemfile 等清单文件)、读取清单提取项目名/依赖/脚本、检测包管理器(Node.js 通过锁文件:pnpm-lock.yaml → pnpm,yarn.lock → yarn,否则 npm)、检测框架、检测数据库、检测入口点、检测脚本命令。非 Node.js 生态系统跳过 Node 专属步骤,改用对应生态的检测规则。
  • Phase 2 确认检测结果:以表格形式展示 9 个自动检测占位符(列:Placeholder、Detected Value、Source),等待用户确认或修正。部分无法自动检测的占位符(如 {TICKET_PATTERN}、{ISSUE_TRACKER_URL}、{TARGET_BRANCH})可保留为手动项。
  • Phase 2.5 选择生态块:根据清单文件选择对应生态标签(package.json→node-ts,pyproject.toml→python,go.mod→go,Cargo.toml→rust,Gemfile→ruby,pom.xml/build.gradle→java)。
  • Phase 3 写入 .claude/CLAUDE.md:读取 CLAUDE.template.md(找不到则回退 CLAUDE.md),移除不匹配生态的块,移除块标记,替换占位符,写入 .claude/CLAUDE.md。
  • Phase 4 验证 CLAUDE.md:读取文件,用正则 {[A-Z_]+} 确认无剩余自动检测占位符(排除 ${...} 形式的 shell 变量引用),输出占位符汇总表。
  • Phase 5 安装规则并回填 CLAUDE.md:定位插件 rules 目录(三级回退),复制 14 条托管规则(auto-loop.md、codex-invocation.md、discretion.md、fix-all-issues.md、scope-discipline.md、framework.md、testing.md、security.md、git-workflow.md、logging.md、docs-writing.md、docs-numbering.md、self-improvement.md、context-management.md)及 2 个覆盖模板(auto-loop-project.md、testing-project.md),更新 .sd0x/install-state.json 清单,并确保 CLAUDE.md 含 @rules/ 引用。
  • Phase 6 安装钩子:定位插件 hooks 目录,复制 6 个钩子(pre-edit-guard.sh、post-edit-format.sh、post-skill-auto-loop.sh、stop-guard.sh、user-prompt-review-guard.sh、post-compact-auto-loop.sh),chmod +x,并将钩子定义合并进 .claude/settings.json。
  • Phase 6.5 安装脚本:复制 5 个脚本(precommit-runner.js、verify-runner.js、review-state.js、lib/utils.js、lib/tree-digest.js),更新清单。
  • Phase 6.7 配置环境变量:检测模型上下文大小,构建环境变量目录,展示建议并等待确认,合并进 .claude/settings.json 的 env 对象。
  • Phase 7 最终验证报告:汇总各阶段,做闭环检查(CLAUDE.md + rules + hooks + env),输出后续步骤。

使用方式

该技能通过标志控制执行范围:

  • 无标志:执行全部阶段,输出完整报告。
  • --detect-only:仅执行 Phase 1-2,输出检测结果。
  • --lite:执行 Phase 1-4,仅生成 CLAUDE.md。
  • --no-rules:跳过规则安装,其余执行。
  • --no-hooks:跳过钩子安装,其余执行。
  • --env-only:仅执行 Phase 6.7,输出环境变量报告。

适用场景

适用于首次搭建项目、需要自动检测框架并生成 CLAUDE.md 配置、需要安装规则/钩子/脚本/环境变量的项目初始化场景。

限制

  • 不适用于 CLAUDE.md 占位符已全部替换(无 {...} 剩余)的情况。
  • 不适用于非 Node.js/TypeScript 且无识别清单文件的项目;此类项目可运行 --detect-only 查看可自动检测的内容,{FRAMEWORK}、{CONFIG_FILE}、{BOOTSTRAP_FILE} 可能需要手动配置。
  • 若仅想修改单个占位符,应直接编辑 CLAUDE.md。
  • 规则或钩子源目录找不到时,对应阶段会硬错误并跳过,Phase 7 报告为部分完成。
  • 脚本源目录找不到时,警告并跳过 Phase 6.5。
  • 该技能使用全新安装语义(安装新文件/跳过相同/冲突警告),不做智能合并;智能合并需直接运行 /install-rules。

暂未提供

该技能的收费、价格、平台支持、实际效果等信息暂未提供。