SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场setup-project

setup-project

部署与运维

查看项目

更新于 10-16 04:01

技能介绍

用途

setup-project 是一个用于初始化与标准化新项目配置的技能。它帮助用户在新项目中自动生成统一的检查（check）脚本，并检测开发环境中已安装的命令行工具（CLI），同时把结果整理进项目文档。适合在开始一个 Node.js、Python、Go 或 Rust 项目时，快速完成脚本配置与环境摸底。

主要能力

1. 检测项目类型

技能会检查以下项目文件来判断类型：

ls package.json pyproject.toml requirements.txt go.mod Cargo.toml 2>/dev/null

并依据 references/cli-detection.md 中的「Deteccion de Tipo de Proyecto」检测表确定项目类型与基础 check 脚本。支持的类型为 Node.js、Python、Go 和 Rust。若未检测到受支持的项目文件，会提示：

No supported project files found. This skill supports Node.js, Python, Go, and Rust projects.

2. 添加 check 脚本

Node.js 项目：读取 package.json 并分析已有脚本，根据可用脚本构建 check 脚本。对应关系如下：

已有脚本 是否纳入 check 命令
lint 是 npm run lint
typecheck 是 npm run typecheck
test 是 npm run test
build 是 npm run build

例如全部存在时生成：

"check": "npm run lint && npm run typecheck && npm run test && npm run build"

同时会通过锁文件检测包管理器（如 npm、bun、pnpm），并在脚本中使用检测到的包管理器命令（例如用 bun run 而非 npm run）。最后通过 Edit 工具把 check 脚本写入 package.json。

Python 项目：对于 pyproject.toml 项目，使用：

"check": "ruff check . && pytest"

仅有 requirements.txt 时使用：

"check": "pytest"

脚本会添加到 pyproject.toml 的 [project.scripts] 下，或建议创建带 check 目标的 Makefile。

Go / Rust 项目：建议创建带 check 目标的 Makefile，命令来自 references/cli-detection.md。

3. 检测已安装的 CLI

使用 references/cli-detection.md 中的检测表与命令来检测 CLI，并以状态表形式展示结果。只有在用户主动要求时，才会显示缺失 CLI 的安装命令。

4. 检测 CI/CD 工作流

执行：

ls .github/workflows/*.yml 2>/dev/null || echo "NO_WORKFLOWS"

若未找到工作流，会提示：

No GitHub Actions workflows configured. Want me to set up basic CI for this project?

若用户同意，可建议运行 /github-actions 技能或提供创建基础工作流的选项。若已存在工作流，则直接报告。

5. 更新或创建项目 CLAUDE.md

检查 CLAUDE.md 是否存在。若存在，则添加或更新「Available CLIs」章节，写入检测到的工具；若不存在，则创建一个精简版，包含：

  • 仓库概览（询问用户或从项目配置推断）
  • Available CLIs 章节（仅列出已安装的 CLI）
  • 快速开始命令

6. 输出摘要

最后输出如下结构的摘要：

Setup Complete
==============

Project Type: [Node.js / Python / Go / Rust]
Package Manager: [npm / bun / pnpm]
Check Script: Added to [package.json / pyproject.toml / Makefile]
  - Includes: [lint, typecheck, test, build]

Available CLIs: X/Y
  - Installed: [list]
  - Missing: [list]

GitHub Actions: [status]

CLAUDE.md: [Updated / Created]

使用方式

该技能通过用户口令触发，例如用户说「setup project」「configurar proyecto」「inicializar proyecto」「agregar npm run check」「que CLIs tengo」等。技能按上述六个阶段依次执行检测、配置和汇总。

适用场景

  • 新项目初始化时希望快速添加统一的 check 命令；
  • 需要了解当前开发环境中安装了哪些 CLI；
  • 需要检查或补全项目的 GitHub Actions CI；
  • 希望为项目生成或更新 CLAUDE.md 以记录环境信息。

限制

  • 仅支持 Node.js、Python、Go 和 Rust 四类项目，其他类型会提示不支持；
  • 缺失 CLI 的安装命令仅在用户主动询问时展示；
  • 具体的 CLI 检测清单、Go/Rust 的 check 命令内容来自外部引用文件，资料中未完整给出；
  • 安装命令等细节资料中暂未提供。