Menu
十步循环 Phase B - 开发阶段执行器，编排 B.1-B.3 步骤。 使用场景："执行开发阶段"、"Phase B"、"创建分支并运行测试"
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/10CG/aria-plugin --skill phase-b-developerThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| name | phase-b-developer |
| description | 十步循环 Phase B - 开发阶段执行器，编排 B.1-B.3 步骤。 使用场景："执行开发阶段"、"Phase B"、"创建分支并运行测试" |
| argument-hint | [--skip-tests] |
| disable-model-invocation | false |
| user-invocable | true |
| allowed-tools | Bash, Read, Write, Glob, Grep, Task, Skill |
版本: 1.4.0 | 十步循环: B.1-B.3 更新: 2026-03-27 - 升级审计触发从 agent-team-audit 改为 audit-engine
使用场景:
不使用场景:
执行前读取 .aria/config.json，缺失则使用默认值。参见 config-loader。
| 字段 | 默认值 | 说明 |
|---|---|---|
audit.enabled | false | 启用 audit-engine 审计 (新) |
audit.checkpoints.post_implementation | "off" | post_implementation 检查点模式 |
experiments.agent_team_audit | false | 旧配置 (向后兼容，自动映射到 audit.*) |
experiments.agent_team_audit_points | ["pre_merge"] | 旧配置 (向后兼容) |
phase_b_developer.framework_build_check.enabled | false | B.2.5 框架 build 验证开关 (Aria #95) |
phase_b_developer.framework_build_check.command | null | build 命令 (如 "npm run build"); null=no-op |
phase_b_developer.framework_build_check.mode | "advisory" | advisory=警告不阻塞 / blocking=失败阻塞进 Phase C |
当 audit.enabled=true 且 audit.checkpoints.post_implementation != "off" 时，B.3 完成后触发 audit-engine (post_implementation 检查点)。
旧配置 experiments.agent_team_audit=true 且 "post_implementation" in agent_team_audit_points 自动映射到新配置。
| 步骤 | Skill | 职责 | 输出 |
|---|---|---|---|
| B.1 | branch-manager | 分支创建 | branch_name |
| B.2 | test-verifier | 测试验证 | test_passed, coverage |
| B.3 | arch-update | 架构同步 | arch_updated |
context:
phase_cycle: "Phase4-Cycle9"
module: "mobile"
changed_files: ["lib/auth.dart", "test/auth_test.dart"]
spec_id: "add-auth-feature" # 来自 Phase A
task_list: [TASK-001, ...] # 来自 Phase A
config:
skip_steps: []
params:
coverage_threshold: 80
branch_prefix: "feature"
B.0 - REQUIRE claim (coordination-claim-lifecycle-and-overlap Part A1, MUST):
precondition: 进入 B.1 前, 本 (container) 必须已有一条本 session 的 active claim
check: phase1_gate telemetry / 编排层记忆 (本 session 是否已跑 phase1_gate)
if_missing:
- MUST 先跑 (不可跳过, advisory 强制 — 步骤级 MUST, 非 hook 硬锁):
python3 "${CLAUDE_PLUGIN_ROOT:-aria}/skills/state-scanner/scripts/phase1_gate.py" \
--raw-track-id "<本 cycle carry-id/Spec id>" --phase B --mode advisory \
[--linked-issue "<repo>#<n>"] --repo-path "<repo root>"
-
[]
B.mid - 审计引擎 (条件触发):
checkpoint: mid_implementation
trigger: B.2 任务执行循环中，每个任务完成后检查进度阈值
condition: audit.enabled == true
AND audit.checkpoints.mid_implementation != "off"
AND tasks_completed_count >= total_tasks * (audit.mid_implementation.threshold / 100)
注意: 每次 Phase B 生命周期内仅触发一次 (触发后置标记，后续任务不再检查)
默认 threshold=50 (已完成任务数 >= 总任务数 × 50%)，来自 config.audit.mid_implementation
步骤:
1. 每个任务完成后更新 tasks_completed_count
2. 检查触发条件 (audit.enabled + checkpoint enabled + progress >=
B.drift - 审计引擎 spec 漂移校验 (条件触发):
checkpoint: mid_post_spec
trigger: B.2 任务执行期, SMOKE / 集成测试暴露 spec 陈述与运行实际不符
condition: audit.enabled == true
AND audit.checkpoints.mid_post_spec != "off"
AND spec_drift_detected
drift 信号 (任一):
- 机械: 测试/SMOKE 报告含 verdict_invalidated_assumptions 字段且非空
- 概念: AI 识别运行实际 (test 行为 / 集成结果) 与 spec 原陈述矛盾
注意: 与 mid_implementation 正交 (后者按进度阈值, 本者按漂移事件);
可在一次 Phase B 内多次触发 (每个独立漂移点一次)
[]
B.post - 审计引擎 (可选):
checkpoint: post_implementation
trigger: B.3 完成后 (实现验证通过后)
condition: 读取 .aria/config.json (via config-loader)
audit.enabled == true
AND checkpoints.post_implementation != "off"
步骤:
1. 通过 config-loader 读取 .aria/config.json audit 块
2. 检查 audit.enabled — false 则跳过，保持现有行为不变
3. 检查 audit.checkpoints.post_implementation — "off" 则跳过
4. 如启用: 调用 audit-engine
- checkpoint: "post_implementation"
- mode: 来自配置 (convergence
success: true
steps_executed: [B.1, B.2, B.3]
steps_skipped: []
results:
B.1:
branch_name: "feature/mobile/TASK-001-add-auth"
B.2:
test_passed: true
coverage: 87.5
B.3:
arch_updated: true
context_for_next:
branch_name: "feature/mobile/TASK-001-add-auth"
test_results:
passed: true
coverage: 87.5
arch_sync_status: "updated"
Phase B 多任务实施期, "当前会话继续 vs 暂停 (形成自然 commit boundary)" 是关键决策点。 不要凭感觉估 context 余量 (实证 #104: 凭感觉 +22% 偏差导致不必要暂停)。调用 aria-context-monitor 机读 runtime-truth:
python3 "${CLAUDE_PLUGIN_ROOT:-aria}/skills/aria-token-telemetry/scripts/token_telemetry.py" --project-root .
source=relay_cache (confidence=high): 读 used_percentage — runtime 真值, 0 偏差source=transcript_fallback (estimate): 读 used_percentage_proxy — window 可能低估, 放宽解读决策阈值 (advisory): <70% 继续 / 70-85% 找 commit boundary / >85% 建议在当前任务收尾后暂停 + commit。
本 skill 只提供数据, 不自动中断 — 暂停决策由 AI 判断。relay 未装时引导 setup_relay.sh。
会话收尾触发 (session-closer TASK-007): 读完 occupancy 后调 session-closer 的 closeout_trigger —— 占用 ≥ 阈值(默认 85%)且有未交接成果(未提交变更 / upm.followups / 新 memory 未入 §8)时 advise 现在 /session-closer 写交接(advisory, 不自动执行)。
契约 (I-1): closeout_trigger 消费 token_telemetry.py 的输出 schema (含 source 字段), 不是 relay cache 原始文件 (无 source → 落 unavailable → 恒不 nudge)。须先跑 token_telemetry 再喂其输出:
TEL=$(mktemp)
python3 "${CLAUDE_PLUGIN_ROOT:-aria}/skills/aria-token-telemetry/scripts/token_telemetry.py" --project-root . > "$TEL"
python3 "${CLAUDE_PLUGIN_ROOT:-aria}/skills/session-closer/scripts/closeout_trigger.py" \
--project-root . --telemetry-json "$TEL"; rm -f "$TEL"
should_nudge=true → 向 owner surface nudge; 否则静默继续。
| 条件 | 跳过步骤 | 检测方法 |
|---|---|---|
| 已在功能分支 | B.1 | 当前分支不是 main/develop |
| 无测试文件 | B.2 (降级) | 变更文件无对应 _test. |
| 无架构变更 | B.3 | 无 ARCHITECTURE.md 变更 |
| emergency hotfix 单测替代 | B.2 单测 (manual prod validation 替代) | hotfix/* 分支 + Prod-Validated: trailer (见下) |
prod 紧急修复 (emergency_hotfix lane, hotfix/* 分支) 中, ops/config 改动 (无业务逻辑可单测) 可用 manual prod validation 替代 B.2 单测 —— 但需 机械 gate:
若 (hotfix/* 分支 AND 拟跳单测):
grep commit message for "^Prod-Validated:" trailer
├── 存在 → 允许 manual prod validation 替代单测 (lighter lane 继续)
└── 缺失 → BLOCK, 回标准 lane (必须写单测 或 补 Prod-Validated trailer + 根因块)
standards/conventions/git-commit.md §6.4。skip_evaluation:
B.1:
- check: git branch --show-current
skip_if: not in [main, master, develop]
reason: "已在功能分支"
B.2:
- check: test file mapping
degrade_if: no corresponding test files
action: 运行但不阻塞，输出警告
B.3:
- check: changed_files
skip_if: no files match *ARCHITECTURE*.md
reason: "无架构文档变更"
╔══════════════════════════════════════════════════════════════╗
║ PHASE B - DEVELOPMENT ║
╚══════════════════════════════════════════════════════════════╝
📋 执行计划
───────────────────────────────────────────────────────────────
B.1 branch-manager → 创建分支
B.2 test-verifier → 测试验证
B.3 arch-update → 架构同步 (跳过 - 无架构变更)
🚀 执行中...
───────────────────────────────────────────────────────────────
✅ B.1 完成 → 分支: feature/mobile/TASK-001-add-auth
✅ B.2 完成 → 测试: 15/15 通过, 覆盖率: 87.5%
○ B.3 跳过 → 理由: 无架构文档变更
📤 上下文输出
───────────────────────────────────────────────────────────────
branch: feature/mobile/TASK-001-add-auth
tests: passed (87.5% coverage)
ready_for: Phase C
输入:
context:
module: "mobile"
changed_files: ["lib/auth.dart", "test/auth_test.dart"]
执行:
B.1: 创建分支 → feature/mobile/TASK-001-add-auth
B.2: 运行测试 → 15/15 通过
B.3: 更新架构 → ARCHITECTURE.md 已更新
输出:
context_for_next:
branch_name: "feature/mobile/TASK-001-add-auth"
test_passed: true
输入:
current_branch: "feature/add-auth" # 已在功能分支
执行:
B.1: 跳过 (已在功能分支)
B.2: 运行测试
B.3: 检查架构
输出:
steps_skipped: [B.1]
branch_name: "feature/add-auth" # 使用现有分支
输入:
changed_files: ["lib/new_feature.dart"] # 无对应测试
执行:
B.1: 创建分支
B.2: 降级模式 (警告无测试)
B.3: 检查架构
输出:
B.2:
mode: "degraded"
warning: "lib/new_feature.dart 没有对应测试"
suggestion: "使用 flutter-test-generator 生成测试"
| 错误 | 原因 | 处理 |
|---|---|---|
| 分支创建失败 | 分支已存在 | 切换到现有分支 |
| 测试失败 | 代码问题 | 停止执行，报告失败 |
| 架构更新失败 | 文档格式错误 | 输出警告，继续执行 |
on_test_failure:
action: stop
report:
- 失败的测试列表
- 错误信息
- 修复建议
next_step: "修复测试后重新运行 Phase B"
phase-a-planner
│
│ context:
│ - spec_id
│ - task_list
▼
phase-b-developer (本 Skill)
│
│ context_for_next:
│ - branch_name
│ - test_results
│ - arch_sync_status
▼
phase-c-integrator
新增于 v1.2.0 - 集成 enforcement-mechanism-redesign 新技能
phase-b-developer
│
├──> branch-manager v2.0.0
│ └── 自动模式决策 (Branch/Worktree)
│
├──> subagent-driver v1.0.0
│ └── Fresh Subagent 执行
│
└──> branch-finisher v1.0.0
└── 完成流程 + 测试验证
B.1 - 分支管理 (增强版):
skill: branch-manager v2.0.0
features:
- 自动模式决策 (5因子评分)
- Branch 模式 (简单任务)
- Worktree 模式 (复杂/并行任务)
mode_decision:
factors:
- file_count: 变更文件数
- cross_directory: 跨目录变更
- task_count: 任务数量
- risk_level: 风险等级
- parallel_needed: 并行需求
threshold: 3 # >= 3 使用 Worktree
output:
mode: "branch" | "worktree"
branch_name: "feature/mobile/TASK-001-xxx"
worktree_path: ".git/worktrees/TASK-001-xxx" # 仅 worktree 模式
B.2 - 开发执行 (增强版):
skill: subagent-driver v1.0.0
features:
- Fresh Subagent 模式
- 任务间代码审查
- 4选项完成流程
- TDD 强制执行 (方案 A)
execution_pattern:
for_each_task:
1. 启动 Fresh Subagent (隔离上下文)
2. 应用 TDD 约束 (RED-GREEN-REFACTOR)
3. 执行任务
4. 任务间代码审查
5. 更新状态
tdd_enforcement:
enabled: true # 自动启用 TDD
mode: "enforce" # enforce | monitor | off
rules:
- test_before_code: true # 必须先写测试
[, , ]
[]
{}
B.3 - 完成流程 (增强版):
skill: branch-finisher v1.0.0
features:
- 测试前置验证
- 4选项完成流程
- Worktree 智能清理
pre_validation:
blocking:
- unit_tests: 单元测试必须通过
- type_check: 类型检查必须通过
- build: 构建必须成功
warning:
- lint: Lint 检查 (可警告通过)
- coverage: 覆盖率检查 (可警告通过)
completion_options:
"[1] 提交并创建 PR":
action: commit + PR
worktree_cleanup: 询问用户
"[2] 继续修改":
action: 返回开发
worktree_cleanup: 否
"[3] 放弃变更":
action: 回滚
worktree_cleanup:
完整 Phase B 执行流程 (v1.2.0):
1. 接收 Phase A 输出
├── spec_id
├── task_list
└── complexity_score
2. B.1 分支管理 (branch-manager)
├── 评估复杂度
├── 决策模式 (Branch/Worktree)
└── 创建分支/Worktree
3. B.2 开发执行 (subagent-driver)
├── 加载任务列表
├── 逐任务执行 (Fresh Subagent)
├── 任务间审查
└── 汇总结果
4. B.3 完成流程 (branch-finisher)
├── 测试前置验证
├── 4选项完成流程
└── Worktree 清理决策
5
phase_b_config:
# branch-manager 配置
branch_manager:
mode_threshold: 3
worktree_base: ".git/worktrees"
branch_prefix: "feature"
# subagent-driver 配置
subagent_driver:
isolation_level: "L2" # L1/L2/L3
enable_inter_task_review: true
critical_blocks: true
# branch-finisher 配置
branch_finisher:
run_tests: true
run_lint: true
run_build: true
coverage_threshold: 85
auto_cleanup: false
# TDD 双保险配置 (v1.3.0 新增)
tdd:
# 方案 A: Fresh Subagent TDD 保护
subagent_level:
enabled: true
mode: "enforce" # enforce | monitor | off
rules:
test_before_code: true
fail_first: true
minimal_implementation: true
# 方案 B: 主会话 TDD 保护 (由 workflow-runner 启用)
session_level:
enabled: true
最后更新: 2026-01-21 Skill版本: 1.2.0
新增于 v1.1.0
Phase B 支持使用 Git Worktrees 创建隔离的开发环境。
use_worktree: true # 启用 worktree 模式
B.1 - 分支创建 (Worktree 模式):
action:
- 使用 branch-manager 的 worktree 创建
- 工作目录: .git/worktrees/{task-name}/
output:
worktree_path: ".git/worktrees/TASK-001-user-auth"
branch_name: "feature/backend/TASK-001-user-auth"
切换到 worktree:
command: cd .git/worktrees/{task-name}/
返回主分支:
command: cd ../..
清理 worktree:
command: git worktree remove .git/worktrees/{task-name}/
| 参数 | 默认值 | 说明 |
|---|---|---|
use_worktree | false | 是否启用 worktree 模式 |
worktree_base | .git/worktrees | worktree 基础路径 |
新增于 v1.1.0
Phase B 扩展支持两阶段评审：规范合规性 → 代码质量。
B.Review - 两阶段评审:
Phase 1 - 规范合规性检查:
enabled: true
blocking: true
checks:
- OpenSpec 格式验证
- UPM 状态同步检查
- 架构文档同步检查
output:
spec_compliance: pass/fail
issues: [...]
Phase 2 - 代码质量检查:
enabled: true
blocking: false # 警告但不阻塞
checks:
- 测试覆盖率检查 (>= 85%)
- 代码复杂度分析
- 安全漏洞扫描
output:
code_quality_score: 0-100
recommendations: [...]
| 检查项 | 说明 | 阻塞 |
|---|---|---|
| OpenSpec 格式 | proposal.md/tasks.md 格式正确 | ✅ |
| UPM 状态 | 进度状态与实际一致 | ✅ |
| 架构文档 | 代码变更与文档同步 | ✅ |
失败处理: 关键问题必须修复后方可继续
| 检查项 | 阈值 | 阻塞 |
|---|---|---|
| 测试覆盖率 | >= 85% | ❌ (警告) |
| 代码复杂度 | <= 10 | ❌ (警告) |
| 安全扫描 | 无高危漏洞 | ❌ (警告) |
失败处理: 记录警告，生成改进建议
评审报告格式:
summary:
phase1_status: "pass"
phase2_status: "warning"
overall_score: 85
phase1_issues:
- severity: "critical"
description: "UPM 状态未更新"
fix_required: true
phase2_recommendations:
- type: "coverage"
current: 82
target: 85
suggestion: "为 AuthManager 添加测试用例"
阻塞条件:
- Phase 1 有 critical 级别问题
- OpenSpec 格式验证失败
绕过选项:
- 用户显式确认 "force_continue"
- 标记为 "technical_debt" (技术债务)
review_config:
enabled: true
phase1:
enabled: true
blocking: true
checks:
openspec_format: true
upm_sync: true
arch_doc_sync: true
phase2:
enabled: true
blocking: false
checks:
test_coverage:
threshold: 85
code_complexity:
threshold: 10
security_scan:
level: "high"
完整流程 (Worktree + 两阶段评审):
B.1 - 创建 Worktree 分支
↓
B.2 - 开发 + 测试验证
↓
B.Review - Phase 1: 规范合规性
↓ (通过)
B.Review - Phase 2: 代码质量
↓ (警告/通过)
B.3 - 架构同步
设计目标: 确保无论通过何种方式执行代码编写，TDD 规则都会被强制执行
┌─────────────────────────────────────────────────────────────────────────┐
│ TDD 保护缺口分析 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 单一保护点的问题: │
│ ┌────────────────┐ ┌────────────────┐ │
│ │ workflow-runner│──┬──▶│ phase-b-dev │ │
│ │ (主会话 Hook) │ │ │ │ │
│ └────────────────┘ │ └────────┬───────┘ │
│ │ │ │
│ │ ├──▶ subagent-driver │
│ │ │ │ │
│ │ │ ▼ │
│ │ │ ┌─────────────┐ │
│ │ │ │Fresh Subagent│ ← 新会话，无 Hook │
│ │ │ └─────────────┘ │
│ │ │ ❌ TDD 保护失效 │
│ │ │ │
│ 用户直接编辑代码 ───┴────────────┴── ❌ 绕过 phase-b │
│ │
└─────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────┐
│ 双保险保护方案 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌────────────────┐ │
│ │ workflow-runner│ │
│ │ Pre-Hook B │ ──▶ 方案 B: 启用主会话 TDD Hook │
│ └────────┬───────┘ ↓ │
│ │ ┌─────────┐ │
│ ▼ │主会话 TDD│ ← 保护用户直接编辑 │
│ ┌────────────────┐ └─────────┘ │
│ │ phase-b-dev │ │
│ │ │ ──▶ 方案 A: 传递 TDD 配置给 Subagent │
│ └────────┬───────┘ ↓ │
│ │ ┌─────────────┐ │
│ └─────────────▶│Subagent TDD │ ← 保护 Fresh Subagent │
│ └─────────────┘ │
│ │
│ ✅ 完整闭环：主会话 + 子会话全覆盖 │
│ │
└─────────────────────────────────────────────────────────────────────────┘
作用对象: subagent-driver 启动的 Fresh Subagent
触发时机: B.2 阶段调用 subagent-driver 时
传递方式: 通过 context 传递 TDD 配置
保护范围: 子会话内的所有代码编写操作
配置:
phase_b_config.tdd.subagent_level:
enabled: true
mode: "enforce"
rules:
test_before_code: true
fail_first: true
minimal_implementation: true
作用对象: workflow-runner 主会话
触发时机: 进入 Phase B 之前的 pre-hook
启用方式: workflow-runner 自动调用 tdd-enforcer
保护范围: 主会话内的所有代码编写操作
配置:
phase_b_config.tdd.session_level:
enabled: true
strict_mode: false
skip_patterns: ["**/*.md", "**/*.json"]
完整 Phase B 执行 (TDD 双保险):
1. workflow-runner pre-hook (方案 B)
├── 检测即将进入 Phase B
├── 调用 tdd-enforcer 启用主会话 TDD
└── 返回 tdd_session_id
2. phase-b-developer 执行
├── B.1: 创建分支
├── B.2: subagent-driver (方案 A)
│ ├── 传递 TDD 配置到 Fresh Subagent
│ ├── Fresh Subagent 启用时加载 TDD 约束
│ └── 每个任务执行时强制 TDD
└── B.3: branch-finisher
├── 运行所有测试
TDD 配置优先级 (从高到低):
1. 项目配置 (.claude/tdd-config.json)
└── 项目级开关，最高优先级
2. 环境变量 (ARIA_TDD_ENABLED)
└── 环境级覆盖
3. phase_b_config.tdd
└── Phase B 级别配置
4. 默认值 (enabled: false)
└── 兜底默认值
# 方式 1: 项目级配置 (.claude/tdd-config.json)
{
"enabled": false
}
# 方式 2: Phase 配置
phase_b_config:
tdd:
subagent_level:
enabled: false
session_level:
enabled: false
# 方式 3: 临时跳过 (特定文件)
# tdd-enforcer 会根据 skip_patterns 自动跳过
最后更新: 2026-06-19 (Aria #95: B.2.5 可选 framework build 验证步骤 + config framework_build_check) Skill版本: 1.5.0