acceptance-pipeline-feature-design

验收流水线功能设计

指导 Agent 设计扩展 Uncle Bob 的验收流水线规范的新功能。产出的内容达到规范级质量——与语言无关、不依赖具体实现，并包含精确的行为要求；风格与严谨程度与原始规范一致。

这是一项组合技能。它不会罗列现有内容（那是 acceptance-pipeline-catalog 的职责），而是提供一套结构化工作流，用于设计后续要添加的内容。

适用场景

• 为变异器设计新的变异策略、值类型或筛选机制
• 为解析器添加新的 Gherkin 语法支持（数据表、标签、Rules 关键字）
• 为 JSON IR 扩展新字段或对象
• 创建新的报告格式（HTML、JUnit XML）或输出通道
• 添加新的流水线阶段或运行模式（并行运行、覆盖率筛选）
• 任何会影响多个流水线组件的规范级变更（横切变更）

前置条件

使用此技能前，请确保 acceptance-pipeline-catalog 可用。该技能提供 9 个必需组件、JSON IR 架构、一致性检查清单（21 项）和 Agent 设置检查清单（15 个步骤）的基准参考。本技能以此为基础。

工作流概览

该工作流分为五个阶段，按顺序执行。每个阶段都基于前一阶段的产出——跳过阶段会导致设计不完整或不一致。

Phase 1: Survey Existing Spec     → Know what exists before proposing changes
Phase 2: Identify Extension Point → Classify where the feature attaches
Phase 3: Draft Feature Spec       → Write the spec section in Uncle Bob's style
Phase 4: Conformance Design       → Add testable conformance items
Phase 5: Impact Analysis          → Assess backward compatibility and migration

顺序为何重要：

• 阶段 1 可避免重复开发现有能力，并确保设计采用既定模式。
• 阶段 2 要求先分类再编写——解析器扩展与报告器扩展的约束不同。
• 阶段 3 根据阶段 2 的分类编写实际的规范文本。
• 阶段 4 确保功能可从实现之外进行测试——如果无法编写一致性检查项，说明规范过于含糊。
• 阶段 5 放在最后，因为需要完整的规范和一致性检查项才能准确评估影响。

使用方法

1. 首先阅读 acceptance-pipeline-catalog 技能，了解当前规范
2. 阅读与你当前工作流步骤对应的阶段参考：

阶段	参考文档	阅读时机
1	调查现有规范	始终适用——任何功能设计的第一步
2	确定扩展点	调查之后——对功能要接入的位置进行分类
3	起草功能规范	分类之后——编写规范章节
4	一致性设计	起草之后——添加可测试的一致性检查项
5	影响分析	一致性设计之后——评估兼容性

3. 按需查阅支持性参考资料：

参考资料	阅读时机
风格指南	阶段 3 期间——Uncle Bob 的规范写作模式
扩展目录	阶段 2 期间——未来扩展的构想和复杂度说明

扩展点快速参考

功能会附加到以下 9 个组件中的一个或多个。JSON IR 是影响最大的扩展点，因为所有组件都会使用它。

扩展点	变更内容	影响级别
解析器	接受新的 Gherkin 语法	中 — 影响 IR 和下游组件
IR	在 JSON 交换格式中添加字段或对象	高 — 影响所有使用方
生成器	新的输出格式或生成策略	低 — 仅影响生成过程
运行时	新的执行模式、钩子、分发机制	中 — 影响处理程序契约
处理程序	新的匹配策略或契约	低至中 — 仅影响步骤匹配
变异器	新的变异策略或筛选器	低 — 仅影响变异模式
报告器	新的报告格式或输出通道	低 — 仅影响报告
流水线	新的阶段或运行模式	高 — 结构性变更
跨组件	涉及多个组件	最高 — 需要仔细分析

输出

工作流会生成以下产物：

1. 功能规范章节 — 可直接插入《验收流水线规范》。采用 Uncle Bob 的风格编写，包含目的段落、行为要求、数据格式和示例。
2. 一致性检查项 — 编号且可测试的项目，用于扩展现有的 21 项检查清单。
3. 影响分析表 — 逐组件评估变更类型、IR 影响、破坏性变更和新增的一致性检查项。

相关技能

• acceptance-pipeline-catalog — 完整规范的基准参考（前置条件）
• clean-code — Uncle Bob 的编码原则（有助于统一风格）

注意事项

请参阅 gotchas.md，了解使用过程中发现的问题点。