Menu
十步循环 Phase A - 规划阶段执行器，编排 A.1-A.3 步骤。 使用场景："执行规划阶段"、"Phase A"、"创建 Spec 并规划任务"
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | phase-a-planner |
| description | 十步循环 Phase A - 规划阶段执行器，编排 A.1-A.3 步骤。 使用场景："执行规划阶段"、"Phase A"、"创建 Spec 并规划任务" |
| disable-model-invocation | false |
| user-invocable | true |
| allowed-tools | Read, Write, Glob, Grep, Task, Skill |
版本: 1.1.0 | 十步循环: A.1-A.3
使用场景:
不使用场景:
| 步骤 | Skill | 职责 | 输出 |
|---|---|---|---|
| A.1 | spec-drafter | Spec 创建/选择 | spec_id, spec_status |
| A.2 | task-planner | 任务规划 | task_list, task_count |
| A.3 | task-planner | Agent 分配 | assigned_agents |
context:
phase_cycle: "Phase4-Cycle9" # 当前进度
module: "mobile" # 目标模块
changed_files: [] # 变更文件 (如有)
user_intent: "开发用户认证" # 用户意图
config:
skip_steps: [] # 跳过的步骤
params:
spec_level: 2 # Spec 级别 (1/2/3)
A.1 - Spec 管理:
skill: spec-drafter
skip_if:
- has_openspec: true # 已有活跃 Spec
- complexity: Level1 # 简单任务
action:
- 检查现有 Spec
- 创建新 Spec 或选择现有
output:
spec_id: "add-auth-feature"
spec_status: "approved"
A.2 - 任务规划:
skill: task-planner
action: plan
skip_if:
- has_detailed_tasks: true # 已有 detailed-tasks.yaml
depends_on: A.1
action:
- 分解 Spec 为具体任务
- 生成 tasks.md 和 detailed-tasks.yaml
output:
task_list: [TASK-001, TASK-002, ...]
task_count: 5
A.3 - Agent 分配:
skill: task-planner
action: assign
depends_on: A.2
action:
- 为每个任务分配最佳 Agent
- 更新 detailed-tasks.yaml
output:
assigned_agents:
TASK-001: backend-architect
TASK-002: mobile-developer
success: true
steps_executed: [A.1, A.2, A.3]
steps_skipped: []
results:
A.1:
spec_id: "add-auth-feature"
spec_status: "approved"
A.2:
task_count: 5
A.3:
agents_assigned: 5
context_for_next:
spec_id: "add-auth-feature"
task_list: [TASK-001, TASK-002, ...]
assigned_agents: {...}
| 条件 | 跳过步骤 | 检测方法 |
|---|---|---|
| 已有活跃 Spec | A.1 | 扫描 openspec/changes/ |
| 复杂度 Level1 | A.1 | 变更文件 ≤3 + 简单类型 |
| 已有 tasks.yaml | A.2, A.3 | 检查 detailed-tasks.yaml |
| emergency hotfix lane | A.1, A.2, A.3 | hotfix/* 分支 (见下) |
prod 紧急修复走 lighter lane (state-scanner emergency_hotfix 规则触发, hotfix/* 分支)。跳 Phase A.1-A.3 (无独立 spec; commit body + Prod-Validated: trailer 取代)。lane 概览:
Prod-Validated: trailer + 根因块 (phase-b 机检; 无 → block 回标准 lane)详见各 phase skill + standards/conventions/git-commit.md §6.4 (Prod-Validated trailer)。
skip_evaluation:
A.1:
- condition: openspec/changes/{any}/proposal.md exists
with_status: [approved, in_progress]
action: skip A.1, use existing spec_id
A.2_A.3:
- condition: detailed-tasks.yaml exists
with_status: not all completed
action: skip A.2 and A.3, use existing tasks
A.post - 审计引擎 (可选):
checkpoint: post_spec
trigger: A.1 完成后 (Spec 创建或更新)
condition: 读取 .aria/config.json (via config-loader)
audit.enabled == true
AND checkpoints.post_spec != "off"
步骤:
1. 通过 config-loader 读取 .aria/config.json audit 块
2. 检查 audit.enabled — false 则跳过，保持现有行为不变
3. 检查 audit.checkpoints.post_spec — "off" 则跳过
4. 如启用: 调用 audit-engine
- checkpoint: "post_spec"
- mode: 来自配置 (convergence / challenge / adaptive)
- context: openspec/changes/{spec_id}/proposal.md
5. 处理 verdict:
- PASS / PASS_WITH_WARNINGS → 继续执行 A.2
- FAIL → 阻塞，输出审计报告，提示修订 Spec
backward_compat:
audit.enabled=false: 完全跳过，Phase A 行为与之前完全相同
旧配置 experiments.agent_team_audit: 由 audit-engine 内部映射处理
fallback_description: |
audit-engine 内部通过 agent-team-audit 单轮引擎执行审计。
直接调用 agent-team-audit 已由 audit-engine 编排层取代。
on_audit_fail: 阻塞进入 A.2，输出审计报告路径
on_skip: 继续执行 A.2 (审计未启用)
output:
audit_verdict: "PASS" # PASS | PASS_WITH_WARNINGS | FAIL (如启用)
audit_report: ".aria/audit-reports/post_spec-{timestamp}.md"
╔══════════════════════════════════════════════════════════════╗
║ PHASE A - PLANNING ║
╚══════════════════════════════════════════════════════════════╝
📋 执行计划
───────────────────────────────────────────────────────────────
A.1 spec-drafter → 创建/选择 Spec
A.2 task-planner → 任务规划
A.3 task-planner → Agent 分配
🚀 执行中...
───────────────────────────────────────────────────────────────
✅ A.1 完成 → Spec: add-auth-feature (approved)
✅ A.2 完成 → 任务数: 5
✅ A.3 完成 → Agent 已分配
📤 上下文输出
───────────────────────────────────────────────────────────────
spec_id: add-auth-feature
task_count: 5
ready_for: Phase B
输入:
context:
user_intent: "添加用户认证功能"
module: "backend"
执行:
A.1: 创建 Level 2 Spec → add-auth-feature
A.2: 分解为 5 个任务
A.3: 分配 Agent
输出:
context_for_next:
spec_id: "add-auth-feature"
task_list: [TASK-001, ..., TASK-005]
输入:
context:
openspec_id: "add-auth-feature" # 已有 Spec
执行:
A.1: 跳过 (已有 Spec)
A.2: 规划任务
A.3: 分配 Agent
输出:
steps_skipped: [A.1]
输入:
context:
has_detailed_tasks: true
执行:
全部跳过 (已有完整规划)
输出:
steps_skipped: [A.1, A.2, A.3]
context_for_next:
# 使用现有规划数据
| 错误 | 原因 | 处理 |
|---|---|---|
| Spec 创建失败 | 信息不足 | 提示用户补充意图 |
| 任务规划失败 | Spec 不完整 | 回退到 A.1 完善 |
| Agent 分配失败 | 未知任务类型 | 使用 general-purpose |
state-scanner
│
▼
phase-a-planner (本 Skill)
│
│ context_for_next:
│ - spec_id
│ - task_list
│ - assigned_agents
▼
phase-b-developer
最后更新: 2026-03-27 Skill版本: 1.1.0
Aria 项目级配置加载器（内部基础设施）。 查找、解析、验证 .aria/config.json 并合并默认值。 此 Skill 不直接触发，由其他 Skills 引用以读取项目配置。
项目状态扫描与智能工作流推荐，十步循环的统一入口。 收集项目状态、分析变更、推荐最佳工作流、引导用户确认执行。 使用场景："查看项目当前状态"、"我要提交代码"、"开发新功能"
会话收尾 —— 在任意对话(含未走完十步循环的探索/调试/讨论 session)把"未交接成果" 固化为 handoff。**与十步循环正交平级的会话仪式**(非周期收尾): AI 先内省本对话出 未完成线程 + 待固化经验, 再用机械 autofill 交叉核验补漏, 写 docs/handoff/。leaf — 终结于写交接, 不拖入十步循环。 使用场景: "对话收尾" / "执行对话收尾" / "会话收尾" / "session closeout" / "收尾这次对话" / "写交接" / "写 handoff" / "收工" / "结束本次对话" / context 快满时主动收尾。 不适用 (用 phase-d-closer): "Phase D" / "周期收尾" / "归档 Spec" / "更新 cycle 进度" —— 那是开发周期收尾, 不是会话收尾。
Git 多远程 parity 检测与 push 验证的共享基础设施。 内部工具, 仅供其他 skills 引用。提供标准化 Bash/Python 执行脚本段 + 输出 JSON schema 契约。
任务到 Agent 的智能路由器，根据任务类型、文件路径自动选择最合适的 Agent。 使用场景：subagent-driver 需要为任务选择 Agent、不确定应该使用哪个 Agent
向 Aria 维护团队报告 Bug 或提交功能建议。自动收集环境信息， 自动路由到 Forgejo（内部用户）或 GitHub（外部用户）。 使用场景："报告 bug"、"report an issue"、"提交功能建议"、 "aria 有个问题想反馈"、"feature request"、"提 issue"、 "反馈问题"、"report bug to aria"