# Strategic Commit Orchestrator > 基于AI-DDD v3.0.0的战略提交编排器，智能分析项目变更设计分组提交计划。 使用场景：需要分组提交多个变更、跨模块协同开发、阶段性成果提交。 - Skill: `10cg/strategic-commit-orchestrator` (Agent Skill, multi-file: 12 files) - Install (CLI): `npx skillmds@latest add 10cg/strategic-commit-orchestrator` - Raw SKILL.md: https://api.skillmd.com/api/skills/10cg/strategic-commit-orchestrator/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: 10cg (https://skillmd.com/u/10cg) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/10cg/strategic-commit-orchestrator --- # Strategic Commit Orchestrator ## 🚀 快速开始 ### 我应该使用这个 Skill 吗？ **决策树**: ``` 有多个提交需要分组？ ├─ 是 → 使用本 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 | ### 快速示例 ```yaml 场景: Backend架构文档批量提交 步骤: 1. 分析变更 → 3个架构文档 (L0 + 2个L1) 2. 分组策略 → Group 1: L0, Group 2: L1文档 3. Subagent分配 → knowledge-manager 4. 执行策略 → 串行 (L0 → L1) 5. 并行执行提交 ``` 完整示例: [EXAMPLES.md](./EXAMPLES.md) --- ## 🎯 核心价值 作为 **Tech-Lead 级别** 的战略提交编排工具，在复杂多模块变更场景下，提供智能的提交分组规划、Subagent 并行编排和项目进度感知能力。 **核心能力**: - ✅ 支持 mobile/backend/frontend/shared 所有模块 - ✅ 基于AI-DDD v3.0.0核心标准 - ✅ 自动识别变更文件所属模块 - ✅ 智能分配专业 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](./CHANGE_TYPES.md) --- ## 🔄 基本使用流程 ```yaml 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 - 标准工作流程](./ADVANCED_GUIDE.md#标准工作流程详解) --- ## 🤖 可用 Subagent | 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#phase-4-subagent-智能分配) --- ## ⚙️ 执行策略 ### 全并行 (Fast Track) - **条件**: 所有分组完全独立，无依赖 - **示例**: 3个不同 Skill 的独立更新 ### 阶段并行 (Phased) - **条件**: 存在阶段性依赖 - **示例**: Phase 1: [A || B], Phase 2: [C] ### 串行 (Sequential) - **条件**: 强依赖关系，必须顺序执行 - **示例**: API定义 → 实现 → 测试 ### 混合 (Hybrid) ⭐ 最常用 - **条件**: 部分并行 + 部分串行 - **执行**: 灵活组合 **详细策略**: [ADVANCED_GUIDE.md - 并行执行编排](./ADVANCED_GUIDE.md#phase-5-并行执行编排) --- ## 📝 提交消息增强 ### 基础格式 ``` (): <中文描述> / 🤖 Executed-By: {subagent_type} subagent 📋 Context: {Phase}-{Cycle} {context} 🔗 Module: {module_name}