Menu
基于AI-DDD v3.0.0的战略提交编排器，智能分析项目变更设计分组提交计划。 使用场景：需要分组提交多个变更、跨模块协同开发、阶段性成果提交。
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 strategic-commit-orchestratorThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| 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
详细流程: 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] → 继续修改
├── []
[]
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 (新增新技能协作支持)