★ FEATURED ARTICLE 【免费下载链接】spec_driven_developSpec-driven development workflow for AI coding agents: architecture-first planning, task decomposition, GitHub Issue/PR tracking, Deep Discuss, and adaptive control for Claude Code, Codex, Cursor, and other Markdown-capable agents.项目地址https://gitcode.com/gh_mirrors/sp/spec_driven_develop点击查看免费下载Spec-Driven Develop是一个面向 AI Coding Agent 的规范驱动开发工作流。它的进度导出功能可一键把开发进度同步为结构化 JSON轻松导入 Linear、Jira、Notion 等项目管理工具配套的Archive 归档机制则会在项目收尾时自动把分析、计划、进度文档存档留痕方便日后溯源。本教程带你完整掌握这套进度外同步 归档留痕的组合拳。为什么需要进度导出与归档用 AI Coding Agent 做大型改造重写、迁移、重构时进度往往散落在 Markdown 文件里❌ 团队协作时进度只存在于MASTER.md的复选框中其他成员在 Linear/Jira 上看不到❌ 项目做完后分析文档、任务分解、进度记录被删除出了问题无法回溯❌ 换平台比如从 Cursor 换到 Claude Code后之前的规划数据难以迁移Spec-Driven Develop 用两个轻量机制解决了这些问题机制解决的问题触发方式进度导出进度数据与外部项目管理工具打通手动运行脚本随时可执行Archive 归档完整工作流留痕支持跨项目溯源所有任务完成后自动进入 Phase 6一键导出进度把 MASTER.md 同步到 Linear / Jira准备工作先获取项目源码仅需 Python 3 标准库无任何第三方依赖git clone https://gitcode.com/gh_mirrors/sp/spec_driven_develop最快配置方法一条命令生成结构化 JSON进入你正在用工作流开发的项目目录指向进度文件夹执行python scripts/export-progress.py docs/progress/脚本会解析docs/progress/下的MASTER.md和各阶段明细文件直接输出一棵完整的 JSON 数据树包含项目元信息任务名称、开始日期、最后更新时间阶段列表每个 Phase 的完成数 / 总任务数 / 完成标记任务明细每个 Task 的优先级Priority、工作量Effort、验收标准Acceptance汇总摘要总阶段数、总任务数、完成百分比progress_percent导出逻辑的核心在 scripts/export-progress.py 的export_progress()函数L109-L139它先解析 MASTER.md 的项目级元数据再按phase-N-*.md文件名匹配补齐每个阶段的任务细节最后计算出进度百分比。导入外部工具拿到 JSON 后你可以Linear / Jira通过它们的 API 或批量导入功能把phases映射为 Epic / 里程碑tasks映射为 Issuepriority、effort字段直接对应原生字段Notion导入为数据库视图按done字段区分状态自建看板summary.progress_percent一个字段就能驱动进度条提示脚本默认解析当前目录下的docs/progress/也可以通过第一个参数指定任意进度目录路径适合对历史归档进度做批量导出。数据从哪来MASTER.md 进度文件解析规则导出的准确性取决于进度文件的规范性。工作流在 Phase 4 生成的进度文档遵循 progress.md 模板其中两类结构化标记是解析的关键① 阶段复选框位于 MASTER.md 的 Phase Checklist 区域- [x] Phase 1: Adaptive Control Foundation (1/1 tasks) - [ ] Phase 2: Workflow Integration (2/4 tasks)[x]/[ ]决定阶段是否完成(N/M tasks)提供任务计数。② 任务复选框位于各阶段明细文件- [ ] **Task 2.1**: 描述 - Priority: P0 - Effort: M - Acceptance: 如何验证完成任务编号、优先级、工作量、验收标准都会被逐字段提取。这就是为什么保持工作流按模板更新进度文件导出的数据就能自动保持与 Linear/Jira 同步——Markdown 文件就是数据源JSON 只是它的结构化投影。Archive 归档机制项目收尾时的自动留痕触发条件当所有任务完成GitHub 模式下所有 Issue 关闭或 LOCAL_ONLY 模式下所有复选框勾选工作流自动进入 SKILL.md 定义的Phase 6: Archive执行 7 个标准动作向用户宣布任务全部完成 根据 Phase 2 确定的任务名生成规范化的目录名小写、连字符把工作产物整体迁移到docs/archives/project-name/GitHub 模式关闭各 Phase 的 Milestone保留为永久记录更新归档索引 docs/archives/README.md只追加、不删除已有条目清理根目录下已搬空的analysis/、plan/、progress/目录建议用户把归档提交到版本控制归档目录结构归档目标结构定义在 archive.md 模板中docs/archives/project-name/ ├── analysis/ # 项目分析文档 ├── plan/ # 任务分解、依赖图、里程碑 ├── progress/ # MASTER.md 与阶段明细 ├── governance/ # 指令/记忆 surface 快照 └── skill/ # 任务专属 Skill如有⚠️一个易踩的坑根目录的AGENTS.md、CLAUDE.md等活跃治理文件归档后依然保留归档目录里只是它们的快照。快照只负责留痕不会干扰后续工作流继续运行。真实案例adaptive-control-layer 归档本仓库就包含一份完整归档实例——docs/archives/adaptive-control-layer/。查看其 progress/MASTER.md 可以看到Phase Checklist三个阶段全部[x]任务数分别为 1/1、4/4、1/1Issue Mapping表记录了 6 个任务的最终状态全部 closedSession Log追加式记录了每次工作会话的摘要drift_score0. Ready for archive配合 plan/task-breakdown.md半年后回看也能完整还原当时为什么这么拆任务——这就是归档留痕的价值它不只是一堆文档而是一份可执行的决策快照。常见问题 FAQQ进度导出会修改进度文件吗不会。脚本是纯只读解析安全可重复执行适合放进 CI 定期生成 JSON。QGitHub 模式下没有 phase-N-*.md 明细文件还能导出吗可以。GitHub 模式下任务状态主要在 Issue 中MASTER.md 的 Phase Checklist 依然会被解析phases的计数数据完整tasks数组为空属于正常情况。Q归档后想恢复进度文件怎么办直接git log找到归档提交即可归档本身建议提交版本控制这也是 Phase 6 最后一步的官方建议。相关文件速查文件作用scripts/export-progress.py进度导出脚本输出结构化 JSONplugins/spec-driven-develop/skills/spec-driven-develop/SKILL.mdPhase 6 归档协议完整定义references/templates/progress.mdMASTER.md 与阶段明细模板references/templates/archive.md归档目录结构与索引模板docs/archives/README.md归档索引追加式记录表✅小结用export-progress.py把 Markdown 进度一键投影到 Linear/Jira 实现跨工具同步用 Phase 6 Archive 把每次工作流完整留痕。两者都零依赖、纯 Markdown 驱动是长周期 AI 协作开发中数据不丢、状态可见的完整闭环。赞分享【免费下载链接】spec_driven_developSpec-driven development workflow for AI coding agents: architecture-first planning, task decomposition, GitHub Issue/PR tracking, Deep Discuss, and adaptive control for Claude Code, Codex, Cursor, and other Markdown-capable agents.项目地址https://gitcode.com/gh_mirrors/sp/spec_driven_develop点击查看免费下载相关推荐从一句话需求到归档交付Spec-Driven Develop 七大阶段工作流逐步实战从一句话需求到归档交付Spec Driven Develop 七大阶段工作流逐步实战 给 AI 编程代理一句话需求它就开始大刀阔斧改代码结果方向跑偏、进度Spec-Driven Develop Deep Discuss 教程7 阶段结构化深度讨论让 AI 先想透再动手Spec Driven Develop Deep Discuss 教程7 阶段结构化深度讨论让 AI 先想透再动手 Spec Driven Develop多 Agent 并行开发不冲突Spec-Driven Develop 并行执行协议与 worktree 隔离实战多 Agent 并行开发不冲突Spec Driven Develop 并行执行协议与 worktree 隔离实战 Spec Driven Develop 是面上一篇FastoNoSQL终极跨平台NoSQL数据库GUI管理工具轻松驾驭Redis、Memcached等12种数据库下一篇react-native-platform-overrideReact Native 树外平台 Override 清单管理与上游变更集成指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
