dsh-cohub 0.4.1 → 0.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/index.js +46 -2
- package/package.json +1 -1
package/lib/index.js
CHANGED
|
@@ -694,10 +694,54 @@ Orchestrator 会在 prompt 中明确指定：
|
|
|
694
694
|
|
|
695
695
|
**输出必须包含**：
|
|
696
696
|
- 子任务列表（含依赖关系）
|
|
697
|
-
- 每个子任务的委派对象（@explorer / @librarian / @fixer / @designer / @oracle / @observer）
|
|
698
|
-
-
|
|
697
|
+
- 每个子任务的委派对象（@explorer / @librarian / @fixer / @designer / @oracle / @observer / @council / @rule-user / @rule-project / @rule-app / @planner）
|
|
698
|
+
- \`## 并行化策略\` 章节（含依赖拓扑说明、并行分组、串行链、收敛分批策略）
|
|
699
699
|
- 验证步骤
|
|
700
700
|
|
|
701
|
+
## 委派代理人选（必读）
|
|
702
|
+
|
|
703
|
+
以下为全部 11 个可用代理，每个子任务必须从其中选择最合适的委派对象。选错代理会导致执行失败或效率低下，务必对照读写权限与触发条件精准匹配。
|
|
704
|
+
|
|
705
|
+
| 代理 | 权限 | 触发条件 / 委派场景 |
|
|
706
|
+
|---|---|---|
|
|
707
|
+
| **co-explorer** | 只读 | 代码库内搜索定位（grep/glob/AST）。需要发现代码库内容、文件结构、符号引用时委派。 |
|
|
708
|
+
| **co-librarian** | 只读+Web | 官方文档/API/GitHub 研究。遇到不熟悉的库、边缘情况、需要外部信息搜索时委派。 |
|
|
709
|
+
| **co-oracle** | 只读 | 架构审查/代码审查/YAGNI 简化/复杂调试。高风险决策、反复出现的 bug、安全审查时委派。 |
|
|
710
|
+
| **co-designer** | 读写 | UI/UX 设计/视觉润色/响应式布局。需要润色的界面、UX 组件、样式调整时委派。 |
|
|
711
|
+
| **co-fixer** | 读写+Bash | 所有代码修改/文件编辑/写入/删除/构建/测试/提交。任何文件操作都委派给 fixer。 |
|
|
712
|
+
| **co-observer** | 只读 | 图片/PDF/截图视觉分析。需要分析多媒体文件内容时委派。 |
|
|
713
|
+
| **co-council** | 只读 | 多模型并行共识。不可逆决策（数据迁移、破坏性 API 变更）时委派。错了还能改 → co-oracle，错了就完了 → co-council。 |
|
|
714
|
+
| **co-rule-user** | 只读 | 分析用户级 AGENTS.md 约束。方案需对照用户级规则时委派。 |
|
|
715
|
+
| **co-rule-project** | 只读 | 分析项目级 AGENTS.md 约束。方案需对照项目级规则时委派。 |
|
|
716
|
+
| **co-rule-app** | 只读 | 分析应用规则文件。规则目录下有多个文件时，按每 1-2 个文件分一组并行启动多个实例。 |
|
|
717
|
+
| **co-planner** | 只读 | 综合需求+信息+规范输出结构化任务分解方案。当需求需要递归委派子方案时，委派自身。 |
|
|
718
|
+
|
|
719
|
+
### 易混淆代理选择决策表
|
|
720
|
+
|
|
721
|
+
| 场景 | 选 A | 选 B | 判断依据 |
|
|
722
|
+
|---|---|---|---|
|
|
723
|
+
| 代码审查 / 架构建议 | **co-oracle** | co-council | 可逆判断：错了还能改，用 oracle 快速给出意见 |
|
|
724
|
+
| 数据迁移 / 破坏性 API 变更 | co-oracle | **co-council** | 不可逆决策：错了就完了，必须多模型共识 |
|
|
725
|
+
| 代码库内搜索定位 | **co-explorer** | co-librarian | 在项目源码内 grep/glob/AST 搜索 |
|
|
726
|
+
| 外部文档/API/Web 研究 | co-explorer | **co-librarian** | 需要访问官方文档、GitHub、Web 搜索 |
|
|
727
|
+
| 代码逻辑/构建/测试 | **co-fixer** | co-designer | 涉及业务逻辑、算法、构建脚本、测试 |
|
|
728
|
+
| UI/UX/视觉/样式 | co-designer | **co-fixer** | 涉及界面、组件外观、CSS、响应式布局 |
|
|
729
|
+
|
|
730
|
+
## 并行化策略（硬性要求）
|
|
731
|
+
|
|
732
|
+
- **依赖分析前置**：先画出子任务依赖拓扑（有向无环图），再基于依赖关系制定并行分组。不得跳过拓扑分析直接标注并行。
|
|
733
|
+
- **串并行标注**：每个子任务必须标注 \`[可并行]\` 或 \`→ 依赖任务X\`，并用分组号（如 \`批次1\`、\`批次2\`）标注并行批次，确保执行顺序一目了然。
|
|
734
|
+
- **并行度克制**：大批量同类任务（如多个文件的同类修改）必须收敛分批，每批 2-3 个任务，禁止无限制并行。即使无依赖，也不得一次性并行超过 3 个任务。
|
|
735
|
+
- **并行决策框架**：
|
|
736
|
+
- 不同文件、无依赖 → 可并行（同一批次）
|
|
737
|
+
- 同一文件存在写冲突 → 串行（按先后顺序分批）
|
|
738
|
+
- 存在数据/产出依赖（任务B需要任务A的输出）→ 串行（依赖任务在前，被依赖任务在后）
|
|
739
|
+
- **按阶段并行指导**：
|
|
740
|
+
- **信息收集阶段**：co-explorer + co-librarian + co-observer 总是并行启动（三者互不依赖，各自独立收集信息）
|
|
741
|
+
- **规则分析阶段**：多个 co-rule-app 实例总是并行启动（按文件分组，每 1-2 个规则文件一个实例）
|
|
742
|
+
- **执行阶段**：修改不同文件的 co-fixer 可并行（同一批次）；同一文件必须串行（按先后顺序分批）
|
|
743
|
+
- **验证阶段**：编译/构建通过后，co-oracle 代码审查 + co-designer UI 审查可并行（两者审查不同维度，互不依赖）
|
|
744
|
+
|
|
701
745
|
**约束**：只读，不修改文件。方案要具体到文件和操作粒度，不可笼统。用 \`todowrite\` 风格的任务列表输出。
|
|
702
746
|
## 执行器环境契约（摘要）
|
|
703
747
|
自包含；先验证再批量（首次用模块/API 先最小探针）；错误可回传。不确定本环境写法时，按全量版（fixer/orchestrator 技能）的探测流程走。
|
package/package.json
CHANGED