zhaixin244-wq 并行开发 Skill
任务
多模块并行开发流程：分析→调度→集成→确认。
流程
Phase 1: Plan Mode 分析
- 用
Glob搜索{module}_work/ds/rtl/*.v获取子模块 RTL 文件列表。若文件不存在，暂停并提示用户 - 确认输入：PR/FS/UA 文档
- RAG 检索 CBB 依赖
- 划分模块，评估依赖关系
- 确定并行组（无依赖模块可并行）
输出格式：
### 模块开发清单
| 模块名 | 依赖 | 复杂度 | 预估工时 | 并行组 |
|--------|------|--------|----------|--------|
| buf_mgr | sync_fifo | 中 | 2h | Group-A |
| ctrl_fsm | 无 | 高 | 3h | Group-A |
| top_int | buf_mgr, ctrl_fsm | 低 | 1h | Group-B |
Phase 2: 并行 Subagent 开发
为每个可并行模块启动独立 subagent：
Agent({
description: "RTL 开发 - {模块名}",
subagent_type: "chip-code-writer",
prompt: "开发 {module_name} 模块 RTL..."
})
调度规则：
| 规则 | 说明 |
|---|---|
| 依赖优先 | 有依赖的模块必须等待依赖完成 |
| 无依赖并行 | 无依赖模块可同时启动 |
| 独立工作目录 | 每个模块使用独立 {module}_work/ |
| 独立检查 | 每个模块独立执行 Lint + 综合 |
Phase 3: 顶层集成
所有子模块完成后：
- 顶层 Lint 检查（ALL PASS）
- 顶层综合检查（ALL PASS + 面积达标）
- 检查模块间接口一致性
Phase 4: PR/FS/UA 确认
| 确认维度 | 检查方法 |
|---|---|
| 功能覆盖 | 对照 FS §4 功能列表 |
| 接口一致 | 对照 FS §6 接口定义 |
| PPA 达标 | 对照 FS §8 PPA 规格 |
| 需求追溯 | 对照 RTM（FS §14） |
冲突检测
监控路径
| 文件类型 | 路径模式 | 冲突级别 |
|---|---|---|
| 顶层 RTL | {module}_work/rtl/{top_module}.v |
Critical |
| CBB 清单 | {module}_work/ds/doc/*_cbb_list.md |
Major |
| SDC 约束 | {module}_work/syn/{top_module}.sdc |
Major |
| 子模块 RTL | {module}_work/rtl/{submodule}.v |
Info（独立目录不冲突） |
文件锁机制（跨平台）
Linux/macOS — flock 原子锁：
lock_file="{module}_work/.lock.{file_type}"
exec 200>"$lock_file"
if ! flock -n 200; then
echo "[CONFLICT] $lock_file held by $(cat $lock_file)"
exit 1
fi
echo "{agent_id}:$(date +%s)" >&200
# ... 执行 ...
exec 200>&- # 释放
Windows — PowerShell Mutex：
$mutex = New-Object System.Threading.Mutex($false, "Global\{module}_{file_type}")
if (-not $mutex.WaitOne(0)) {
Write-Error "[CONFLICT] Mutex held by another process"
exit 1
}
# ... 执行 ...
$mutex.ReleaseMutex()
$mutex.Dispose()
平台检测逻辑：
if command -v flock >/dev/null 2>&1; then
# Linux/macOS: 使用 flock
...
elif command -v powershell >/dev/null 2>&1; then
# Windows: 调用 PowerShell mutex
powershell -File lock.ps1 ...
else
# fallback: 文件存在性检查（有竞态风险，仅用于开发环境）
...
fi
flock 优势：原子操作，不存在"检查-写入"竞态窗口；进程崩溃时 fd 自动关闭释放锁。
冲突行为
| 冲突级别 | 行为 |
|---|---|
| Critical | 暂停，等待用户协调，不自动合并 |
| Major | 暂停，提示冲突文件，等待确认 |
| Info | 记录日志，继续执行 |
输出
- 各模块 RTL + 质量报告
- 顶层集成 RTL + 质量报告
- PR/FS/UA 确认报告
使用示例
示例 1：
- 用户：「data_adpt 有 3 个子模块，帮我并行开发」
- 行为：分析依赖关系，无依赖模块（如 buf_mgr、ctrl_fsm）编入 Group-A 并行启动 subagent，有依赖模块（如 top_int）编入 Group-B 等待，完成后顶层集成
示例 2：
- 用户：「检查多模块并行开发是否有文件冲突」
- 行为：扫描各模块工作目录，检查顶层 RTL、CBB 清单、SDC 约束等共享文件是否有并发写入冲突，输出冲突报告
异常处理
| 场景 | 触发条件 | 处理动作 |
|---|---|---|
| 子模块依赖环 | 模块间存在循环依赖 | 暂停，输出依赖环图，等待用户重新划分 |
| 文件锁冲突 | 多 subagent 同时写入同一文件 | Critical 级别暂停，等待用户协调 |
| Subagent 超时 | 单个模块开发超时无响应 | 记录超时模块，继续其他模块，汇总后重试 |
| 顶层集成失败 | 子模块接口不一致 | 输出接口差异表，定位不一致模块 |
检查点
检查前：
- 确认 PR/FS/UA 文档齐全
- 确认模块划分和依赖关系已明确
- 确认各模块工作目录独立
检查后：
- 确认所有子模块 RTL 已生成且 Lint 通过
- 确认顶层集成 Lint ALL PASS + 面积达标
- 确认 PR/FS/UA 确认报告已输出