mcpField
S
spec-driven-init

spec-driven-init

github.com/kw12121212开发137 次安装26 周前更新
代码仓库

关于 spec-driven-init

spec-driven-init 用于在项目中初始化规格驱动工作流。它会创建或修复项目脚手架、起草项目背景，并帮助将现有行为记录为规格。

主要功能

  1. 01初始化或修复脚手架
  2. 02起草项目背景
  3. 03记录现有行为
  4. 04更新规格索引

适用场景

  1. 01设置规格驱动工作流
  2. 02修复不完整的脚手架
  3. 03记录项目现有行为

安装

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

$npx skills add https://github.com/kw12121212/auto-spec-driven --skill spec-driven-init

安装后在 Claude Code 中输入/spec-driven-init确认已加载。

详细介绍

你正在帮助用户在项目中初始化规范驱动工作流。

此技能的命令

如果你记不起此技能使用的确切命令，请在运行任何操作前查阅此处。 不要猜测。

init: node {{SKILL_DIR}}/scripts/spec-driven.js init [path]

前提条件

当前环境必须能够访问目标项目目录。 继续操作前，请确认你计划初始化的路径存在且是预期的项目根目录。

步骤

  1. 确认目标项目 — 询问要初始化哪个项目。如果用户当前已在项目根目录，则使用当前目录。接受 . 或显式路径。

  2. 运行 init — 运行：

    node {{SKILL_DIR}}/scripts/spec-driven.js init [path]

    仅当路径与当前目录不同时才传递该路径。

    • 如果 .spec-driven/ 不存在，此操作会从头进行引导初始化， 包括 roadmap/、specs/ 和 changes/
    • 如果 .spec-driven/ 已存在，此操作会修复缺失的脚手架文件， 并重新生成 specs/INDEX.md，且不会覆盖现有文件

  3. 起草项目背景 — 阅读描述项目的现有文件（README.md、AGENTS.md、CLAUDE.md、package.json、pom.xml 等）。起草一段 3–5 句的 context 内容，涵盖：

    • 项目的用途
    • 技术栈和使用的语言
    • 值得注意的关键约定或限制

    将草稿写入 .spec-driven/config.yaml 的 context 字段，然后展示给用户并询问是否需要调整。

  4. 记录现有行为 — 询问：“这个项目是否已有值得记录的行为？”如果有，帮助用户按照标准格式在 .spec-driven/specs/<category>/ 下编写初始规范文件：

    • 按领域划分（例如 auth/、api/、core/）
    • 使用带有 RFC 2119 关键词的 ### Requirement: <name> 标题
    • 描述系统当前的行为，而不是它应该有的行为
    • 在 .spec-driven/specs/INDEX.md 中为每个新文件添加条目

    对现有项目而言，此步骤很重要——没有初始规范，propose 就没有可读取的内容，也无法检测冲突。

  5. 确认 — 向用户展示创建的内容，并建议运行 /roadmap-plan 来制定路线图，或运行 /spec-driven-propose 来创建第一个变更。

规则

  • 不要创建任何变更——仅进行初始化
  • context 字段应保持简洁：3–5 句足以供 AI 使用
  • 如果 .spec-driven/ 已存在，不要覆盖现有文件；仅修复缺失的脚手架文件

评论

支持 Markdown