用途
Feature Workflow 是用于 AI 编程智能体的功能开发工作流,解决的是跨会话、跨智能体、跨并行功能时“上下文丢失、计划过时、文档失真”的问题。核心原则一句话:计划承载工作,文档承载真相。
主要能力
- 分离计划与文档:
.plans/<name>.md是单个任务的工作记忆,随时可改、便于头脑风暴、临时存在,功能上线后删除;_docs/是权威事实来源,记录系统当前如何运行、第三方 API 行为、既有模式,长期有效且具有权威性。 - 计划格式固定:包含状态(brainstorm、approved、in-progress、blocked、shipped)、最后核对日期与漂移说明,以及 Goal、Decisions(已锁定选择及原因)、Open Questions、Current State(经核实的当前真实状态)、Next Steps(有序恢复点)、Regression Guard、Out of Scope、Source of Truth(链接到 _docs/、API 文档、关键 file:line)。任务列表、测试用例、数据模型放在 Next Steps 或 Current State 之下。
- 打开即核对(reconcile-on-open):读取计划后,逐条对照真实代码或数据库核实所有“已完成”声明,把漂移记入 Current State,重写 Next Steps,更新 Last reconciled 时间戳,然后才开始行动。任何未经核实的勾选都不可信。
- 路线图契约:每个计划实现
_docs/features/<feature>/roadmap.md中的一个条目。开始时把条目设为 [in-progress] 并链接计划;上线时设为 [shipped]、移除计划链接、提升持久事实、删除计划;放弃时恢复为 [planned] 并删除计划。技术债与产品债记录在同一 roadmap.md 的独立分区,跨切面基础设施债记录在_docs/architecture/roadmap.md。 - 不凭空编造:改动第三方集成或既有子系统前,先读其 _docs/ 条目;文档与现实冲突时以现实为准,修复文档并标注来源(API URL、file:line、commit)以便核实。
使用方式
以功能名调用,例如“feature-workflow risk-profiling”或“pick up the bottom-nav work”。加载顺序为:功能路线图 → 关联计划(或按格式新建并标记路线图为 in-progress)→ 计划 Source of Truth 部分链接的所有文档 → 执行 reconcile-on-open → 向人报告当前状态、发现的漂移和下一步。第 4 步之前不得改代码。工作中发现持久事实时,在计划删除前提升进 _docs/。
适用场景
多个功能并行开发、多个智能体共享同一计划和文档、需要跨会话恢复工作、需要高可靠上下文传递的编程任务。对于高风险对抗式构建(配合 gated-build 技能),功能计划文件即该构建的锚点文档,审查轨迹、证据台账和墓碑记录作为其章节存在。
限制
资料未提供平台、收费、价格或效果方面的信息。该技能依赖智能体自觉遵守流程;类别选择依据为编程与开发。