القائمة
基于AI-DDD v3.0.0的战略提交编排器，智能分析项目变更设计分组提交计划。 使用场景：需要分组提交多个变更、跨模块协同开发、阶段性成果提交。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
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"
| name | strategic-commit-orchestrator |
| description | 基于AI-DDD v3.0.0的战略提交编排器，智能分析项目变更设计分组提交计划。 使用场景：需要分组提交多个变更、跨模块协同开发、阶段性成果提交。 |
| argument-hint | [--dry-run] |
| disable-model-invocation | false |
| user-invocable | true |
| allowed-tools | Bash, Read, Grep, Task |
决策树:
有多个提交需要分组？
├─ 是 → 使用本 skill
│ └─ 主项目 + 子模块都有变更？
│ ├─ 是 → 类型E 全项目流程
│ └─ 否 → 跨多个模块？
│ ├─ 是 → 跨模块流程
│ └─ 否 → 单模块分组流程
└─ 否 → 使用 commit-msg-generator
快速场景匹配:
| 场景 | 使用? | 类型 | 说明 |
|---|---|---|---|
| 📁 创建多个架构文档 | ✅ | B | 文档批量提交 |
| 🔄 Backend + Mobile 协同开发 | ✅ | D | 跨模块提交 |
| 🎯 Phase/Cycle 结束里程碑 | ✅ | B/D | 阶段成果提交 |
| 🔧 大规模重构 | ✅ | A/B | 多文件分组 |
| 🌐 OpenSpec + Skills + Standards | ✅ | E | 全项目变更 |
| 📦 主项目 + 子模块同时变更 | ✅ | E | 全项目变更 |
| 📝 单文件修改 | ❌ | - | 直接用 commit-msg-generator |
| 🐛 单个 Bug 修复 | ❌ | - | 直接用 commit-msg-generator |
场景: Backend架构文档批量提交
步骤:
1. 分析变更 → 3个架构文档 (L0 + 2个L1)
2. 分组策略 → Group 1: L0, Group 2: L1文档
3. Subagent分配 → knowledge-manager
4. 执行策略 → 串行 (L0 → L1)
5. 并行执行提交
完整示例: EXAMPLES.md
作为 Tech-Lead 级别 的战略提交编排工具，在复杂多模块变更场景下，提供智能的提交分组规划、Subagent 并行编排和项目进度感知能力。
核心能力:
✅ 使用前必读: 根据变更类型选择正确的处理方式
| 类型 | 特征 | UPM处理 | Phase/Cycle | 示例 |
|---|---|---|---|---|
| 类型A | 业务功能子模块变更 | 读取子模块UPM | 使用实际进度 | mobile/**, backend/** |
| 类型B | 主项目变更 | 读取主模块UPM | 使用主模块进度 | docs/**, .claude/skills/**, scripts/** |
| 类型C | 跨项目共享基础设施 | 无UPM | 使用逻辑阶段 | standards/**, .claude/agents/** |
| 类型D | 跨模块协同变更 | 读取主模块UPM | 使用主模块进度 | Backend + Mobile + API契约 |
| 类型E | 全项目变更 | 混合策略 | 各自处理 | 主项目 + 子模块同时变更 |
详细识别规则: CHANGE_TYPES.md
1. 识别变更类型 → A / B / C / D / E
2. 读取项目状态
→ 类型A: 读取子模块UPM
→ 类型B/D: 读取主模块UPM
→ 类型C: 跳过UPM，使用逻辑阶段
→ 类型E: 混合策略 (见下方说明)
3. 分析变更并分组
→ 按职责、依赖关系分组文件
→ 类型E: 先扫描所有子模块变更
4. 分配 Subagent
→ knowledge-manager / backend-architect / mobile-developer 等
5. 执行提交
→ 使用 Task 工具并行/串行执行
6. 验证结果
→ 检查 git log，确认提交成功
详细流程: ADVANCED_GUIDE.md - 标准工作流程
| Subagent | 专长领域 | 适用场景 |
|---|---|---|
| knowledge-manager | 架构文档、知识库 | _ARCHITECTURE.md, docs/ |
| backend-architect | 后端系统、API | backend/**/*.py, API实现 |
| mobile-developer | Flutter/Dart、UI | mobile/lib/**/*.dart |
| api-documenter | API文档、OpenAPI | shared/contracts/*.yaml |
| qa-engineer | 测试、质量保证 | test/**/_test. |
| tech-lead | 技术决策、重构 | Skill开发, 重大重构 |
| general-purpose | 通用任务 | 配置修改, 简单更新 |
详细能力映射: ADVANCED_GUIDE.md - Subagent分配
详细策略: ADVANCED_GUIDE.md - 并行执行编排
<type>(<scope>): <中文描述> / <English description>
<Body>
🤖 Executed-By: {subagent_type} subagent
📋 Context: {Phase}-{Cycle} {context}
🔗 Module: {module_name}
<Footer>
类型A (业务功能子模块):
→ 从子模块 UPM 读取实际进度
→ 示例: Phase4-Cycle9
类型B (主项目变更):
→ 从主模块 UPM 读取实际进度
→ 示例: Phase2-Cycle3
类型C (跨项目共享基础设施):
→ 使用逻辑阶段描述（无UPM）
→ 示例: Phase1-Cycle1 standards-unification
类型D (跨模块协同变更):
→ 从主模块 UPM 读取
→ 示例: Phase3-Cycle7
类型E (全项目变更):
→ 子模块: 各自策略 (A/C)
→ 主项目: 读取主模块UPM
→ 示例: 主项目 Phase2-Cycle3 + standards Phase1-Cycle1
增强标记格式: commit-msg-generator/ENHANCED_MARKERS_SPEC.md
完整实践: ADVANCED_GUIDE.md - 最佳实践
| 问题 | 症状 | 快速解决 |
|---|---|---|
| Git冲突 | 多个Task同时修改同一文件 | 暂停 → 解决冲突 → 重启 |
| Task失败 | Subagent超时/失败 | AgentOutputTool查看输出 |
| 格式错误 | Git hook拒绝提交 | git commit --amend 修正 |
详细处理: ADVANCED_GUIDE.md - 故障处理
完整清单: TROUBLESHOOTING.md - 检查清单
新增于 v2.3.0 - 集成 enforcement-mechanism-redesign 新技能
strategic-commit-orchestrator
│
├──> branch-manager v2.0.0
│ └── 自动模式决策 + Worktree 信息
│
├──> subagent-driver v1.0.0 (可选)
│ └── 批量任务执行
│
└──> branch-finisher v1.0.0
└── 4选项完成流程入口
协作点:
1. 模式感知:
- 获取当前隔离模式 (Branch/Worktree)
- Worktree 模式下调整提交策略
2. Worktree 路径:
- 获取 worktree_path (如果存在)
- 确保在正确目录执行 git 操作
使用方式:
# 获取 branch-manager 输出
context:
mode: "worktree"
worktree_path: ".git/worktrees/TASK-001-xxx"
branch_name: "feature/mobile/TASK-001-xxx"
# 调整提交策略
if mode == "worktree":
# 确保在 worktree 目录执行
git_cwd: worktree_path
协作点:
1. 批量任务执行:
- 大规模重构时使用 subagent-driver 执行
- 利用 Fresh Subagent 隔离
2. 任务间审查:
- 复用 inter-task review 机制
- 提交前验证代码质量
使用场景:
- 类型A/D: 多子模块协同变更
- 类型E: 全项目批量提交
示例:
# 使用 subagent-driver 执行多组提交
for group in commit_groups:
subagent_driver.execute_task(
task: f"提交 {group.name}",
files: group.files,
subagent: group.recommended_agent
)
协作点:
1. 完成流程入口:
- 所有提交完成后调用 branch-finisher
- 执行测试验证 + 4选项选择
2. Worktree 清理:
- 委托 branch-finisher 处理清理决策
- 不直接清理 worktree
调用时机:
after: 所有分组提交完成
before: Phase C (PR 创建)
流程:
1. strategic-commit-orchestrator 完成所有提交
↓
2. 调用 branch-finisher
├── 测试前置验证
└── 4选项完成流程
↓
3. 根据用户选择
├── [1] → Phase C
├── [2] → 继续修改
├── [3] → 回滚
└── [4] → 暂停
collaboration_config:
# branch-manager 协作
branch_manager:
enabled: true
mode_aware: true # 感知隔离模式
worktree_support: true # 支持 worktree 路径
# subagent-driver 协作 (可选)
subagent_driver:
enabled: false # 默认不启用
use_for:
- large_refactor # 大规模重构
- type_e_changes # 类型E变更
isolation_level: "L2"
# branch-finisher 协作
branch_finisher:
enabled: true
auto_call: true # 自动调用
call_after: "all_commits_done"
| 文档 | 职责 | 加载场景 |
|---|---|---|
| CHANGE_TYPES.md | 变更类型识别 | 确定A/B/C/D/E类型 |
| WORKFLOW_CORE.md | 通用流程 (Phase 2-6) | 每次提交 |
| WORKFLOW_TYPE_A.md | 子模块变更流程 | 类型A |
| WORKFLOW_TYPE_B.md | 主项目变更流程 | 类型B |
| WORKFLOW_TYPE_C.md | 跨项目共享流程 | 类型C |
| WORKFLOW_TYPE_D.md | 跨模块协同流程 | 类型D |
| WORKFLOW_TYPE_E.md | 全项目变更流程 | 类型E (v2.2.0新增) |
| SUBMODULE_GUIDE.md | 子模块处理指南 | 类型E (v2.2.0新增) |
| TROUBLESHOOTING.md | 故障处理+最佳实践 | 遇到问题时 |
| EXAMPLES.md | 完整工作流示例 | 学习参考 |
| CHANGELOG.md | 版本历史 | 了解变更 |
@standards/conventions/git-commit.md@standards/core/progress-management/ai-ddd-progress-management-core.md v1.0.0@{module}/[docs/]project-planning/unified-progress-management.md版本: 2.3.0 最后更新: 2026-01-21 Skill版本: 2.3.0 (新增新技能协作支持)