SuperAPI AI 工具集

grace-generate

编程与开发

查看项目

更新于 10-16 03:13

技能介绍

用途:为指定 GRACE 模块生成代码,并附带完整的语义标记。适用于模块已在 development-plan.xml 中完成规划与契约定义、需要落地实现的场景。

前置条件:docs/development-plan.xml 必须包含该模块的契约;docs/knowledge-graph.xml 必须已登记该模块。若缺失,需先运行 $grace-plan。

主要流程:

  1. 加载上下文。独立生成时读取目标模块在知识图谱中的条目、其依赖模块及依赖契约;控制器驱动的多智能体生成时,以控制器的执行包为主要事实来源,若执行包已含契约、图谱条目、依赖摘要、写入范围与验证命令,则无需重读整个计划与图谱。
  2. 按 GRACE 标记结构生成代码,包括文件头、模块契约、模块映射、变更摘要、组件契约,以及约每 500 token 一个的 START_BLOCK/END_BLOCK 标记;注释语法按项目语言适配。
  3. 产出图谱同步结果:独立模式直接更新知识图谱;多智能体模式不直接编辑共享 XML,而是返回图谱增量提案。
  4. 在模块范围内验证,运行类型检查、lint 与模块本地测试,优先确定性本地断言。
  5. 返回实现包,含变更文件、模块本地验证结果、图谱同步输出或增量提案、开放假设与集成风险。

粒度规则:块约 500 token,块名在文件内唯一,且描述“做什么”而非“怎么做”。除非控制器或用户明确修改计划,不得扩大写入范围。

限制:资料未提供具体支持语言、安装方式、收费与平台信息。