# Agent Feature

> 触发：加个功能、实现一个功能、新增特性、给项目加 X、做个小需求、feature 流水线｜English: add a feature, implement X, new feature pipeline, feature development｜特性开发流水线（编排 6 个 sub agent）：analyst 验收→planner 计划→executor 实现→test-engineer 跑绿→code-reviewer 评审→verifier 取证；适用于给现有项目加明确新特性（需求清晰、不需 autopilot）。

- Skill: `wangyuanchuan2022/agent-feature` (Agent Skill)
- Install (CLI): `npx get-skill add wangyuanchuan2022/agent-feature`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wangyuanchuan2022/agent-feature/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: wangyuanchuan2022 (https://skillmd.com/u/wangyuanchuan2022)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/wangyuanchuan2022/agent-feature

---


# 特性开发流水线（agent-feature）

> 编排 6 角色：analyst → planner → executor → test-engineer → code-reviewer → verifier。
> 派活方式、回收监控、失败处理与 `agent-autopilot` 完全一致（主路径 agent_spawn / 降级 de_session+personas；错峰 15s；双条件完成标准；回收核对）。本技能不重复，只写差异。
> 溯源对应：六席执行顺序对应 OMC team 的 team-plan / team-prd / team-exec / team-verify 四阶段（analyst+planner ≙ plan/prd，executor ≙ exec，test-engineer 及之后 ≙ verify）。
> ⚠️ 工作区纪律：子会话不传 cwd（继承用户派发任务的工作区）；项目子目录路径在任务书里用相对前缀表达（详见 agent-autopilot「工作区纪律」）。

## Step 0 · 尺寸分级

| 档 | 信号 | 相位掩码（对应下方执行顺序步骤号） |
|---|---|---|
| trivial | 1 文件几行 / 无新依赖 / 一眼显然 | 跳过 1-2（组织者把验收标准写进任务书）→ 3 → 4 → 6；评审单席 |
| small | 1 文件 1 函数 / 无 / 读码即清晰 | 1 轻量（主会话自查，不派席）→ 2 一步计划 → 3 → 4 → 5 单席 → 6 |
| standard | 2-5 文件 / 可能新增内部模块 / 一个真实取舍 | 全 6 步标准跑；**explore 前置（默认）**——planner 前先派 explore 勘察（analyst 步已带 8+5 检索面产出时可豁免，豁免须在任务书注明） |
| large | 跨切面 / 新外部依赖·公共 API / 多个开放问题 | 全 6 步 + planner 加 architect 交叉评审 + 评估拆批；**explore 前置（硬门）**——无勘察材料不进 planner |

- **tie-breaker：触碰安全面或公共 API/契约 ⇒ 至少 standard**（security-reviewer 并行双评必派），与文件数无关

## 执行顺序

### 1. analyst（HIGH，只读）——需求转验收
- 输入：用户的特性描述 + 目标项目现状（可先让主会话快速 glob/read 一眼，或派 explore 补勘察）
- **explore 前置分档（2026-10-01 P1-④，源自 fastapi 评测实证：无 explore 前置的 planner 21 分钟 vs 有前置 11 分钟——前置勘察净省 planner 半程）**：standard 档默认派 explore（LOW）先做接入点/现状勘察再进 planner；large 档硬门（无勘察材料不进 planner）；analyst 步已产出 8+5 检索面发现表时 standard 档可豁免（豁免在任务书注明）；small/trivial 档主会话自查即可不派席
- **brownfield 接入（可选，analyst 前置）**：目标是接手不熟悉的老仓库/无文档存量代码时，先派 `spec-miner`（HIGH，只读）做规格提取、产出规格再进 analyst；派席口径与产出约定见 `agent-review-squad`「评审面复用路由表」brownfield 行（单一事实源，不在本技能复制），与 analyst（前瞻设计）/explore（代码勘察）的边界以该表为准
- **计划前固定检索面 8+5**：8 类检索（相似实现/命名约定/错误处理/日志模式/类型定义/测试模式/配置/依赖）+ 5 条追踪（入口点/数据流/状态变更/契约/架构模式），产出统一发现表；不适用项显式声明 N/A 及原因
- 输出：验收标准清单（每条可测试）+ 边界与非目标 + 需求缺口提问
- 缺口大 → 组织者 ask_user_question 补齐后再继续

### 2. planner（HIGH）——分步计划
- 输入：验收标准清单；standard/large 档须附 explore 勘察材料（接入点清单/现状注记——large 档无勘察材料不开工，退回步骤 0 补勘察）
- 输出：3-6 步计划，每步带涉及文件与完成判据；标注哪些步可并行
- **歧义裁决交付要求**：需求存在 ≥2 种合理解读时，计划必须含【歧义裁决】节（候选解释/选择方案/依据/翻转条件四要素，与 planner 人格 Ambiguity_Ruling 节同口径）；无歧义也显式记一句「未识别到多解读歧义」（实证：fastapi 评测 C0 单席因歧义 silently 落地挂 5 题，两席 planner 独立同裁 = 编排第一价值位点）
- **门：计划呈用户批准**（轻特性可并入第 1 步产出一次批）

### 3. executor（MEDIUM）——逐步实现
- 每步一个任务书：文件范围 + 完成判据 + 最小 diff 纪律
- **每步收尾跑 formatter check**：standard 档默认只报告不阻断；strict 档须用户显式声明且非零退出码即阻断；扩展名映射表见 agent-autopilot Phase 2
- 可并行的步错峰派多个 executor；碰同一文件的步串行

### 4. test-engineer（MEDIUM）——测试锁行为
- 为新特性补单元/集成测试；全量测试跑绿
- 不绿回步骤 3 定向修（循环 ≤2 轮）

### 5. code-reviewer（HIGH，只读）——分级评审
- 对特性全部 diff 出 P0/P1/P2 + 文件:行号 + 【改进点】
- 涉及安全面（输入/鉴权/密钥）→ 升级为与 security-reviewer 并行双评

### 6. verifier（MEDIUM，只读）——取证收尾
- 对照第 1 步验收标准逐条取证：新鲜测试输出 + 实际运行证据
- 全过 → 交付报告；有未证项 → 如实标注，不宣布完成

## 与 agent-autopilot 的关系
- 特性需求**不清晰**（只有模糊想法）→ 先走 requirement-interview 或直接用 agent-autopilot（其 Phase 0 会补扩写）
- 特性**清晰**、规模中等 → 本技能（少两个阶段，更快）

## 触发方式
- 「加个特性：X」「实现 X 功能」「走 feature 流水线」
- 判据：能指名目标项目 + 一句话说清特性 = 需求基本清晰

## 投递纪律（全局，2026-09-19 用户钉死）

- 子会话/评审员的完成与状态汇报一律**点对点直投**组织者会话 ID（任务书必须预写 ORG 会话 ID）；
- **严禁群发**：禁用 `project:` 伪接收者与多收件人广播——该形态会唤醒目录下全部 idle 会话，消耗各会话唤醒预算；
- **每条消息只允许唤醒一个会话**；有 ORG ID 时一律直投，仅在 ID 确实不可得时降级为其他形态，且降级须在汇报中注明；
- 需多方知晓的信息由组织者逐会话转发或汇总说明，执行会话不得代发。

