SuperAPI AI 工具集

vibe-soc-loop

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:作为 vibe_soc 的高层调度器,负责选择正确的仓库规则、技能、MCP 工具与状态转换,本身不重复底层技能的具体契约。适用于功能开发、RTL/物料重构、顶层集成、寄存器生成、CRG 设计表、验证与恢复、综合/PD、评审与提交就绪度检查等流水线工作。

必要前置:先阅读仓库 AGENTS.md;按任务读取对应规则,如流水线工作读 ../../rules/01_swarm_flow.md、02_toolchain.md、05_pipeline_state.md,物料 RTL 变更读 10_rtl_change_gate.md,验证失败恢复读 11_verif_recovery_gate.md,综合或 PD 读 12_syn_pd_gate.md,评审或提交读 13_review_gate.md,手工 RTL 风格读 04_coding_style.md,设计决策读 06_design_knowledge.md。需分别解析项目根、工作区、状态模块名、RTL 顶层与测试平台顶层;chip/top 的状态模块是 vibe_soc_top,当前 RTL 顶层是 chip_earlgrey_asic,不得互相推断。阶段工作前先查询 pipeline_state.json,仅在不存在时通过经验证的状态辅助工具初始化。评审请求需选 review_mode=quick|normal|strict,默认 normal,干跑规划用 quick,提交或 PR 前用 strict。

分类与所有权:先判定归属再选执行器。生成的顶层、wrapper、寄存器 RTL、CRG RTL、RTL/文件列表、接口或约束变更均受流水线治理,须由 soc-pipeline 加相应阶段角色拥有,底层技能与 MCP 工具只执行工作、不得绕过状态门。架构、物料 RTL、生成 RTL/top/wrapper、多阶段恢复归 soc-pipeline/阶段角色;独立 lint/编译/仿真/回归/覆盖率/综合请求归相应阶段角色,由 soc-build 执行;只读端口提取、快照或接口差异由 coordinator 交 soc-integrate;OpenROAD 物理设计交接由 soc-pd-engineer 交 soc-openroad;循环审计、验证证据、提交就绪度由 soc-reviewer 用 check_loop_state.py 及只读检查;已批准的源表转换且无 RTL 输出由 coordinator 交 excel-yml-gen、crg-req-to-design 或 cr-tree-diag-gen。若所需角色或执行器缺失,应精确报告阻塞,不得手写生成顶层、CRG 逻辑,也不得直接跑仿真、综合或用 OpenROAD shell 兜底。

循环契约:受治理工作时,编辑前把所属阶段标记为 in_progress;产物限于 docs/、de/rtl/、de/run/、de/syn/、dv/tb/、dv/sim/;必需检查须经注册的 MCP 工具,MCP 不可用视为阶段阻塞或失败而非绕过许可;失败时读真实日志或报告、分类、必要时更新状态并回退到最早受影响阶段;仅当产物存在、记录的检查全部通过且 pipeline_state.json 记录真实证据时才关闭阶段;下游修复 RTL 需按 01 与 05 的失效规则处理。阶段后评审或提交就绪度由 soc-reviewer 在阶段负责人完成后派发,评审发现视为后续工作,不向 pipeline_state.json 增加评审阶段。有模块工作区时,可运行 .agents/scripts/check_loop_state.py <workspace> --mode <review_mode> 作为只读证据。评审派发需包含评审域、报告/交付物、knowledge_scope 与请求的 top-risk 数量,并遵循 13_review_gate.md 的结构化报告与来源权威门;只有 soc/review/rule_library/ 提供项目规则,其他知识库源为参考证据,空占位须标记 Need Human Confirmation。

汇报:循环工作的最终回复须包含任务分类与所选底层技能/工具、变更文件、状态转换或无需转换的原因、检查项及通过/失败证据或未运行原因、评审结论或无需评审原因、下一阻塞或建议阶段。完成时附带紧凑证据块,含 module、task_class、review_mode、state、tools、artifacts、result 等字段。