mcpField
F
feature-workflow

feature-workflow

github.com/arraydude开发2133 次安装16 周前更新
代码仓库

关于 feature-workflow

为开发者和 AI Agent 提供功能开发工作流指南,覆盖规格编写、阶段拆分、进度跟踪、PR 策略与归档。内容以 19 条规则组织,适用于从需求分析到功能完成的协作过程。

主要功能

  1. 01规定规格文档结构与内容
  2. 02将实施工作拆分为阶段
  3. 03跟踪阶段进度与完成情况
  4. 04制定 PR 范围和分支策略
  5. 05归档规格与实施经验

适用场景

  1. 01为新功能或迁移编写规格
  2. 02将开发计划拆成可审查阶段
  3. 03跟踪各阶段实施进度
  4. 04完成合并后归档规格和经验

安装

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

$npx skills add https://github.com/arraydude/agent-skills --skill feature-workflow

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

包含的文件

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

AGENTS.md
rules/
archive-preservation-format.md
archive-when-to-archive.md
phase-decomposition.md
phase-dependency-ordering.md
phase-zero-foundation.md
pr-branch-naming.md
pr-per-phase-strategy.md
pr-scope-and-review.md
pr-target-develop-branch.md
spec-content-sections.md
spec-current-state-analysis.md
spec-living-document.md
spec-structure.md
tracking-completion-reports.md
tracking-metrics-tables.md
tracking-status-indicators.md
workflow-collaboration-loop.md
workflow-iteration-patterns.md
workflow-spec-placement.md

详细介绍

功能工作流

关于功能规划、规范编写、实现和归档的全面指南。包含 6 个类别中的 19 条规则,源自 18 份以上已完成的功能规范。

适用时机

在以下情况下参考这些指南:

  • 开始开发新功能或进行迁移
  • 创建或更新规范文档
  • 将工作拆分为多个实现阶段
  • 跟踪规范中的进度
  • 决定 PR 范围和分支策略
  • 完成功能并归档规范

按优先级划分的规则类别

优先级类别影响前缀
1规范结构与内容严重spec-
2阶段设计严重phase-
3进度跟踪高tracking-
4PR 策略高pr-
5归档中archive-
6工作流协作中workflow-

快速参考

1. 规范结构与内容(严重)
  • spec-structure - 规范文档的必需结构(标题、元数据、目录、章节)
  • spec-content-sections - 各章节必须包含的内容(执行摘要、目标、架构、计划、测试、验收标准)
  • spec-current-state-analysis - 始终从当前状态入手:代码清单、附有证据的问题
  • spec-living-document - 在整个实现过程中更新规范,切勿删除历史记录
2. 阶段设计(严重)
  • phase-zero-foundation - 阶段 0 始终用于基础设施工作
  • phase-decomposition - 将工作拆分为可独立审查和交付的阶段
  • phase-dependency-ordering - 按依赖关系链排列阶段顺序
3. 进度跟踪(高)
  • tracking-status-indicators - 使用一致的状态指示标记和进度跟踪器
  • tracking-completion-reports - 为每个阶段撰写完成报告
  • tracking-metrics-tables - 纳入前后指标对比表
4. PR 策略(高)
  • pr-target-develop-branch - 严重:功能 PR 始终以 develop 为目标,绝不以 main 为目标
  • pr-per-phase-strategy - 每个阶段一个 PR,便于审查
  • pr-branch-naming - 分支命名遵循 GitFlow 约定
  • pr-scope-and-review - 保持 PR 聚焦,并清晰记录范围
5. 归档(中)
  • archive-when-to-archive - 所有阶段完成且 PR 合并后再归档
  • archive-preservation-format - 保留完成说明、经验总结和指标
6. 工作流协作(中)
  • workflow-collaboration-loop - AI 与开发者之间的迭代规划
  • workflow-spec-placement - 将规范放在相关软件包的 .claude/ 目录下
  • workflow-iteration-patterns - 需求变更时的迭代方式

核心工作流

  1. 探索 - 开发者描述功能或问题
  2. 分析 - 探索代码库,记录当前状态
  3. 提案 - 起草规范,列出架构和阶段
  4. 审查 - 开发者审查并提供反馈
  5. 完善 - 根据反馈更新规范
  6. 批准 - 开发者确认计划
  7. 实现 - 按阶段实施,每个阶段分别提交 PR
  8. 归档 - 移动已完成的规范,并记录经验总结

使用方法

阅读各条规则文件,了解详细说明和代码示例:

rules/spec-structure.md
rules/phase-decomposition.md
rules/tracking-status-indicators.md
rules/pr-per-phase-strategy.md
rules/archive-when-to-archive.md
rules/workflow-collaboration-loop.md

每个规则文件都包含:

  • 简要说明规则的重要性
  • 错误示例(反模式)
  • 正确示例(最佳实践)

完整汇编文档

如需包含所有规则详细说明的完整指南,请参阅:AGENTS.md

评论

支持 Markdown