Skip to content

Chinese Overview

Jump to bottom
zhu1090093659 edited this page Jun 8, 2026 · 1 revision

Spec-Driven Develop 中文介绍

Spec-Driven Develop 是一个面向 AI Coding Agent 的纯 Markdown 工作流插件。它适用于 Claude Code、Codex、Cursor，以及其他能读取自定义 Skill 或项目规则的 Agent。

它解决的问题很明确：当任务从“改一个函数”变成“迁移、重写、重构、架构改造、长周期开发”时，Agent 不能直接开写。它需要先理解项目、拆分任务、建立进度追踪、保留跨会话上下文，并在执行偏离计划时及时纠偏。

一句话概括

Spec-Driven Develop 把大型软件改造变成一条规范驱动闭环：项目分析、意图精炼、任务分解、GitHub Issue/PR 追踪、进度连续性、项目治理、执行验证和自适应控制。

核心能力

能力 说明
规范驱动开发 先分析和规划，再执行代码变更
任务分解 把大任务拆成阶段、任务、依赖和并行泳道
GitHub 原生追踪 可自动使用 Issues、Milestones、Labels、Projects、worktree 和 PR
跨会话连续性 通过 docs/progress/MASTER.md 和 GitHub 状态恢复进度
S.U.P.E.R 架构原则 用五个原则约束架构质量
自适应控制 用 drift_score 检测计划偏移，并触发提醒、重规划或重新确认范围
项目治理与记忆 明确 AGENTS.md、CLAUDE.md、平台规则和原生 memory surface 的职责
Deep Discuss 用于技术问题分析、方案讨论和决策前推理

什么时候使用？

适合使用 Spec-Driven Develop 的场景：

  • “把这个项目重写成 Rust / Go / TypeScript。”
  • “迁移到新框架。”
  • “重构整个项目。”
  • “做一次架构改造。”
  • “拆成微服务。”
  • “把功能完整做完，并建立测试和进度追踪。”

适合使用 Deep Discuss 的场景：

  • “讨论一下这个问题。”
  • “帮我分析根因。”
  • “我在两个方案之间纠结。”
  • “这个架构选择你怎么看？”
  • “先别写代码，先把问题想清楚。”

S.U.P.E.R 是什么？

S.U.P.E.R 是这个项目的架构原则：

  • S — Single Purpose：一个模块只做一件事。
  • U — Unidirectional Flow：数据和依赖单向流动。
  • P — Ports over Implementation：先定义接口和数据契约，再写实现。
  • E — Environment-Agnostic：配置、依赖和运行环境不要硬编码。
  • R — Replaceable Parts：组件应该可以替换，而不引发连锁改动。

为什么说它是纯 Markdown？

核心工作流就是 SKILL.md 和 references/ 下的 Markdown 文档。没有 SDK，没有运行时，没有 API key。只要 Agent 能读取自定义指令、Skill 或系统提示词，就可以使用。

支持哪些平台？

已提供明确安装路径的平台：

  • Claude Code
  • Codex
  • Cursor

通用 Markdown 方式也可用于：

  • Windsurf
  • Cline
  • Aider
  • Continue
  • Roo Code
  • Augment
  • 其他支持自定义指令的 AI Coding Agent

安装入口

主仓库：

https://github.com/zhu1090093659/spec_driven_develop

Codex：

codex plugin marketplace add zhu1090093659/spec_driven_develop --ref main

Cursor：

bash <(curl -sL https://raw.githubusercontent.com/zhu1090093659/spec_driven_develop/main/scripts/install-cursor.sh)

Claude Code：

/plugin marketplace add zhu1090093659/spec_driven_develop
/plugin install spec-driven-develop@spec-driven-develop

相关页面

Spec-Driven Develop

Repository

Clone this wiki locally