mcpField
S
speckit-initial

speckit-initial

github.com/full-stack-skillsAgent 工作流064 次安装4 周前更新
代码仓库

关于 speckit-initial

用于初始化 Spec Kit 项目的技能，供希望在项目中启用规范驱动开发流程的 Agent 使用。它通过 Specify CLI 创建 .specify/ 结构，并为所选 Agent 注册斜杠命令。

主要功能

  1. 01初始化 .specify/ 项目结构
  2. 02为指定 Agent 注册斜杠命令
  3. 03选择 Bash 或 PowerShell 脚本
  4. 04支持当前目录或新子目录
  5. 05可跳过 Git 相关设置

适用场景

  1. 01在新项目中启用 Spec Kit
  2. 02为项目切换 Agent 并配置命令
  3. 03在 Windows 环境使用 PowerShell 脚本初始化

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/full-stack-skills/speckit-skills --skill speckit-initial

安装后在 Claude Code 中输入/speckit-initial确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
examples/
linux-claude.md
macos-cursor.md
windows-copilot-ps.md

详细介绍

Spec Kit 初始 Skill

运行 specify init 以初始化 Spec Kit 项目：拉取 .specify/（记忆、脚本、模板、规格），并向选定的 AI Agent 注册 /speckit.* 斜杠命令。本 Skill 假设已安装 Specify CLI；如果尚未安装，请先引导用户使用 speckit-install。

适用场景

  • 首次在项目中启用 Spec Kit（“初始化 Spec Kit”“在此处设置 Spec Kit”）。
  • 切换 AI Agent（例如从 Claude 切换到 Cursor 或 Gemini）。
  • 在新目录或现有目录中初始化。
  • 在 Windows 上需要 PowerShell 脚本（--script ps）。

前提条件

  • 已安装 Specify CLI（参见 speckit-install）。如果 specify 不在 PATH 中，请引导用户先运行 speckit-install。
  • Git（可选；如果项目不是 git 仓库，或你想跳过与 git 相关的设置，请使用 --no-git）。

工作流

  1. 验证 CLI

    • 如果用户报告“找不到 specify 命令”或尚未安装 CLI，请先引导他们使用 speckit-install。否则继续。

  2. 选择参数

    • --ai（斜杠命令必需）：claude | cursor-agent | gemini | copilot | windsurf | qwen | opencode | codex | qoder | amp | shai | bob | kilocode | auggie | roo | codebuddy — 选择用户将在此项目中使用的 Agent。
    • --script：sh（默认，Bash）或 ps（PowerShell）。当 Windows 用户需要 PowerShell 脚本时，使用 ps。
    • 目标路径：当前目录使用 specify init . 或 specify init --here；新建子目录使用 specify init <project_name>。
    • --force：如果已存在 .specify/，则覆盖（请谨慎使用）。
    • --no-git：跳过与 git 相关的设置。
    • --ignore-agent-tools：不安装或检查特定于 Agent 的工具；仅拉取模板和 .specify/ 结构。
    • --github-token 或 GITHUB_TOKEN：用于私有仓库或访问受限的情况。

  3. 运行命令

    • 根据用户的操作系统和所选 Agent，提供具体命令。示例：
      • 当前目录，Cursor：specify init . --ai cursor-agent
      • 当前目录，Claude：specify init . --ai claude
      • Windows、Copilot、PowerShell 脚本：specify init . --ai copilot --script ps
      • 新建子目录：specify init my-app --ai gemini

  4. 确认输出

    • 成功后：项目中包含 .specify/（记忆、脚本、模板、规格），且 Agent 可使用 /speckit.* 斜杠命令。

输出

  • 项目：包含记忆、脚本、模板和规格的 .specify/ 目录。
  • Agent：所选 AI Agent 中可用的斜杠命令（例如 /speckit.constitution、/speckit.specify、/speckit.plan）。

后续步骤

  • 运行 speckit-check 验证环境（可选，但建议）。
  • 然后使用 speckit-constitution 或 speckit-specify 开始 Spec Kit 工作流。

不同环境

环境示例
Linux / macOS、Cursorspecify init . --ai cursor-agent
Linux / macOS、Claudespecify init . --ai claude
Windows、Copilot、PowerShellspecify init . --ai copilot --script ps
新建子目录specify init my-project --ai gemini
覆盖现有 .specifyspecify init . --ai claude --force
无 gitspecify init . --ai claude --no-git
仅模板（无 Agent 工具）specify init . --ai claude --ignore-agent-tools

故障排除

  • “specify: command not found”：请先使用 speckit-install。
  • Windows 上未显示斜杠命令：如果 Agent 需要 PowerShell，请确保使用了 --script ps，并确认 Agent 已配置为从项目中加载命令。
  • 私有仓库 / 访问受限：按 spec-kit 文档设置 GITHUB_TOKEN 或传入 --github-token <token>。

参考资料

评论

支持 Markdown