关于 feature-workflow
为开发者和 AI Agent 提供功能开发工作流指南,覆盖规格编写、阶段拆分、进度跟踪、PR 策略与归档。内容以 19 条规则组织,适用于从需求分析到功能完成的协作过程。
主要功能
- 01规定规格文档结构与内容
- 02将实施工作拆分为阶段
- 03跟踪阶段进度与完成情况
- 04制定 PR 范围和分支策略
- 05归档规格与实施经验
适用场景
- 01为新功能或迁移编写规格
- 02将开发计划拆成可审查阶段
- 03跟踪各阶段实施进度
- 04完成合并后归档规格和经验
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ arraydude/ agent-skills --skill feature-workflow安装后在 Claude Code 中输入/feature-workflow确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
AGENTS.mdrules/archive-preservation-format.mdarchive-when-to-archive.mdphase-decomposition.mdphase-dependency-ordering.mdphase-zero-foundation.mdpr-branch-naming.mdpr-per-phase-strategy.mdpr-scope-and-review.mdpr-target-develop-branch.mdspec-content-sections.mdspec-current-state-analysis.mdspec-living-document.mdspec-structure.mdtracking-completion-reports.mdtracking-metrics-tables.mdtracking-status-indicators.mdworkflow-collaboration-loop.mdworkflow-iteration-patterns.mdworkflow-spec-placement.md详细介绍
功能工作流
关于功能规划、规范编写、实现和归档的全面指南。包含 6 个类别中的 19 条规则,源自 18 份以上已完成的功能规范。
适用时机
在以下情况下参考这些指南:
- 开始开发新功能或进行迁移
- 创建或更新规范文档
- 将工作拆分为多个实现阶段
- 跟踪规范中的进度
- 决定 PR 范围和分支策略
- 完成功能并归档规范
按优先级划分的规则类别
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 1 | 规范结构与内容 | 严重 | spec- |
| 2 | 阶段设计 | 严重 | phase- |
| 3 | 进度跟踪 | 高 | tracking- |
| 4 | PR 策略 | 高 | 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- 需求变更时的迭代方式
核心工作流
- 探索 - 开发者描述功能或问题
- 分析 - 探索代码库,记录当前状态
- 提案 - 起草规范,列出架构和阶段
- 审查 - 开发者审查并提供反馈
- 完善 - 根据反馈更新规范
- 批准 - 开发者确认计划
- 实现 - 按阶段实施,每个阶段分别提交 PR
- 归档 - 移动已完成的规范,并记录经验总结
使用方法
阅读各条规则文件,了解详细说明和代码示例:
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