你可以使用Specify CN CLI来引导你的项目, 这将在你的环境中引入所需的制品. 运行:

specify-cn init <project_name>

或在当前目录初始化:

specify-cn init .
# 或使用 --here 标志
specify-cn init --here
# 跳过确认当目录已有文件时
specify-cn init . --force
# 或
specify-cn init --here --force

系统会提示你选择正在使用的AI代理. 你也可以直接在终端中主动指定:

specify-cn init <project_name> --ai claude
specify-cn init <project_name> --ai gemini
specify-cn init <project_name> --ai copilot
specify-cn init <project_name> --ai cursor-agent
specify-cn init <project_name> --ai qwen
specify-cn init <project_name> --ai opencode
specify-cn init <project_name> --ai codex
specify-cn init <project_name> --ai windsurf
specify-cn init <project_name> --ai amp
specify-cn init <project_name> --ai kilocode
specify-cn init <project_name> --ai auggie
specify-cn init <project_name> --ai roo
# 或在当前目录: 
specify-cn init --here --ai claude
specify-cn init --here --ai codex
# 强制合并到非空的当前目录
specify-cn init --here --force --ai claude

CLI会检查你是否安装了Claude Code、Gemini CLI、Cursor CLI、Qwen CLI、opencode或Codex CLI. 如果你没有安装, 或者你希望在不检查正确工具的情况下获取模板, 请在命令中使用 --ignore-agent-tools:

specify-cn init <project_name> --ai claude --ignore-agent-tools

转到项目文件夹并运行你的AI代理. 在我们的示例中, 我们使用 claude.

如果你看到 /speckit.constitution、/speckit.specify、/speckit.plan、/speckit.tasks 和 /speckit.implement 命令可用, 就说明配置正确.

第一步应该是使用 /speckit.constitution 命令建立项目的指导原则. 这有助于确保在所有后续开发阶段中做出一致的决策:

/speckit.constitution 创建专注于代码质量、测试标准、用户体验一致性和性能要求的原则. 包括这些原则应如何指导技术决策和实施选择的治理.

此步骤会创建或更新 .specify/memory/constitution.md 文件, 其中包含项目的基础指南, AI代理将在规范、规划和实施阶段参考这些指南.

有了项目原则后, 你现在可以创建功能规范. 使用 /speckit.specify 命令, 然后为你想要开发的项目提供具体需求.

[!IMPORTANT] 尽可能明确地说明你要构建的什么和为什么. 此时不要关注技术栈.

示例提示:

开发Taskify, 一个团队生产力平台. 它应该允许用户创建项目、添加团队成员、
分配任务、评论并以看板风格在板之间移动任务. 在此功能的初始阶段, 
我们称之为"创建Taskify", 我们将有多个用户, 但用户将提前预定义.
我想要两个不同类别的五个用户, 一个产品经理和四个工程师. 让我们创建三个
不同的示例项目. 让我们为每个任务的状态使用标准的看板列, 如"待办"、
"进行中"、"审核中"和"已完成". 此应用程序将没有登录, 因为这只是
确保我们基本功能设置的第一次测试. 对于UI中的任务卡片, 
你应该能够在看板工作板的不同列之间更改任务的当前状态.
你应该能够为特定卡片留下无限数量的评论. 你应该能够从该任务
卡片中分配一个有效用户. 当你首次启动Taskify时, 它会给你一个五个用户的列表供你选择.
不需要密码. 当你点击用户时, 你进入主视图, 显示项目列表.
当你点击项目时, 你会打开该项目的看板. 你将看到列.
你将能够在不同列之间来回拖放卡片. 你将看到分配给你的任何卡片, 
即当前登录用户, 与其他卡片颜色不同, 以便你快速看到你的卡片.
你可以编辑你所做的任何评论, 但不能编辑其他人所做的评论. 你可以
删除你所做的任何评论, 但不能删除其他人所做的评论.

输入此提示后, 你应该看到Claude Code启动规划和规范起草过程. Claude Code还将触发一些内置脚本来设置仓库.

完成此步骤后, 你应该有一个新创建的分支(例如, 001-create-taskify), 以及 specs/001-create-taskify 目录中的新规范.

生成的规范应包含一组用户故事和功能需求, 如模板中所定义.

在此阶段, 你的项目文件夹内容应类似于以下内容:

└── .specify
    ├── memory
    │	 └── constitution.md
    ├── scripts
    │	 ├── check-prerequisites.sh
    │	 ├── common.sh
    │	 ├── create-new-feature.sh
    │	 ├── setup-plan.sh
    │	 └── update-cluade-md.sh
    ├── specs
    │	 └── 001-create-taskify
    │	     └── spec.md
    └── templates
        ├── plan-template.md
        ├── spec-template.md
        └── tasks-template.md

创建了基线规范后, 你可以继续澄清在第一次尝试中未正确捕获的任何需求.

你应该在创建技术计划之前运行结构化澄清工作流程, 以减少下游的返工.

首选顺序:

1. 使用 /speckit.clarify(结构化)- 顺序的、基于覆盖率的提问, 将答案记录在澄清部分.
2. 如果仍然感觉模糊, 可以选择性地进行临时自由形式细化.

如果你有意跳过细节澄清环节(例如，进行概念验证或探索性原型设计), 请明确说明, 这样智能体就不会因缺少澄清信息而停滞不前.

一个自由形式的优化提示示例(在 /speckit.clarify 之后如果仍然需要):

对于你创建的每个示例项目或项目, 每个项目应该有5到15个之间的可变数量任务, 
随机分布到不同的完成状态. 确保每个完成阶段至少有一个任务.

你还应该要求Claude Code验证审核和验收清单, 勾选验证/通过要求的项目, 未通过的项目保持未勾选状态. 可以使用以下提示:

阅读审核和验收清单, 如果功能规范符合标准, 请勾选清单中的每个项目. 如果不符合, 请留空.

重要的是, 要将与Claude Code的互动作为澄清和围绕规范提问的机会——不要将其第一次尝试视为最终版本.

你现在可以具体说明技术栈和其他技术要求. 你可以使用项目模板中内置的 /speckit.plan 命令, 使用这样的提示:

我们将使用.NET Aspire生成这个, 使用Postgres作为数据库. 前端应该使用
Blazor服务器与拖拽任务板、实时更新. 应该创建一个REST API, 包含项目API、
任务API和通知API.

此步骤的输出将包括许多实施细节文档, 你的目录树类似于:

.
├── CLAUDE.md
├── memory
│	 └── constitution.md
├── scripts
│	 ├── check-prerequisites.sh
│	 ├── common.sh
│	 ├── create-new-feature.sh
│	 ├── setup-plan.sh
│	 └── update-cluade-md.sh
├── specs
│	 └── 001-create-taskify
│	     ├── contracts
│	     │	 ├── api-spec.json
│	     │	 └── signalr-spec.md
│	     ├── data-model.md
│	     ├── plan.md
│	     ├── quickstart.md
│	     ├── research.md
│	     └── spec.md
└── templates
    ├── CLAUDE-template.md
    ├── plan-template.md
    ├── spec-template.md
    └── tasks-template.md

检查 research.md 文档, 确保根据你的说明使用了正确的技术栈. 如果任何组件突出显示, 你可以要求Claude Code完善它, 甚至让它检查你想要使用的平台/框架的本地安装版本(例如, .NET).

此外, 如果你选择的技术栈是快速变化的(例如, .NET Aspire、JS框架), 你可能想要要求Claude Code研究有关所选技术栈的详细信息, 使用这样的提示:

我希望你查看实施计划和实施细节, 寻找可能从额外研究中受益的领域, 
因为.NET Aspire是一个快速变化的库. 对于你识别的需要进一步研究的那些领域, 
我希望你使用有关我们将在Taskify应用程序中使用的特定版本的额外详细信息更新研究文档, 
并启动并行研究任务, 使用网络研究澄清任何细节.

在此过程中, 你可能会发现Claude Code卡在研究错误的内容——你可以使用这样的提示帮助它朝着正确的方向推进:

我认为我们需要将其分解为一系列步骤. 首先, 识别你在实施期间需要做的不确定
或从进一步研究中受益的任务列表. 写下这些任务的列表. 然后对于这些任务中的每一个, 
我希望你启动一个单独的研究任务, 这样最终结果是我们并行研究所有这些非常具体的任务.
我看到你所做的是看起来你在研究.NET Aspire一般情况, 我认为这对我们不会有太大帮助.
那太没有针对性的研究了. 研究需要帮助你解决特定的针对性问题.

[!NOTE] Claude Code可能过于急切, 添加你没有要求的组件. 要求它澄清变更的理由和来源.

有了计划后, 你应该让Claude Code检查它, 确保没有遗漏的部分. 你可以使用这样的提示:

现在我希望你去审核实施计划和实施细节文件.
带着确定是否存在从阅读中可以明显看出的你需要做的一系列任务的眼光来阅读.
因为我不确定这里是否足够. 例如, 当我查看核心实施时, 参考实施细节中的适当位置
会很有用, 以便在它执行核心实施或细化中的每个步骤时可以找到信息.

这有助于完善实施计划, 并帮助你避免Claude Code在其规划周期中遗漏的潜在盲点. 一旦初始细化完成, 在你可以进入实施之前, 要求Claude Code再次检查清单.

你也可以要求Claude Code(如果你安装了GitHub CLI)继续从你当前的分支向 main 创建一个详细描述的pull request, 以确保工作得到正确跟踪.

[!NOTE] 在让代理实施之前, 还值得提示Claude Code交叉检查细节, 看看是否有任何过度设计的部分(记住——它可能过于急切). 如果存在过度设计的组件或决策, 你可以要求Claude Code解决它们. 确保Claude Code遵循项目章程作为建立计划时必须遵守的基础.

实施计划验证通过后, 你现在可以将计划分解为具体的、可执行的任务, 这些任务可以按正确的顺序执行. 使用 /speckit.tasks 命令从你的实施计划自动生成详细的任务分解:

/speckit.tasks

此步骤会在你的功能规范目录中创建一个 tasks.md 文件, 其中包含:

• 按用户故事组织的任务分解 - 每个用户故事成为一个独立的实施阶段, 包含自己的任务集
• 依赖管理 - 任务按依赖关系排序, 尊重组件间的依赖(例如, 模型在服务之前, 服务在端点之前)
• 并行执行标记 - 可以并行运行的任务用 [P] 标记, 以优化开发工作流
• 文件路径规范 - 每个任务包含实施应发生的确切文件路径
• 测试驱动开发结构 - 如果要求测试, 则包含测试任务并排序为在实施之前编写
• 检查点验证 - 每个用户故事阶段包含检查点以验证独立功能

生成的 tasks.md 为 /speckit.implement 命令提供了清晰的路线图, 确保系统性实施, 保持代码质量并允许用户故事的增量交付.

准备就绪后, 使用 /speckit.implement 命令执行你的实施计划:

/speckit.implement

/speckit.implement 命令将:

• 验证所有先决条件都已就绪(章程、规范、计划和任务)
• 解析 tasks.md 中的任务分解
• 按正确顺序执行任务, 尊重依赖关系和并行执行标记
• 遵循任务计划中定义的 TDD 方法
• 提供进度更新并适当处理错误

[!IMPORTANT] AI代理将执行本地CLI命令(如 dotnet、npm 等)- 确保你在机器上安装了所需的工具.

实施完成后, 测试应用程序并解决任何在CLI日志中可能不可见的运行时错误(例如, 浏览器控制台错误). 你可以将此类错误复制粘贴回AI代理以进行解决.