SuperAPI AI 工具集

weed

编程与开发

查看项目

更新于 10-16 06:21

技能介绍

weed 是 Allium 生态中的技能,用于检查 .allium 规格与实现代码是否一致,找出分歧并协助解决。

用途:对比规格文件与对应实现代码,双向报告不一致——规格声明 X 而代码做 Y,或代码做了规格未描述的事。

主要能力:支持三种模式——check(只报告不修改)、更新规格(让规格匹配代码现状)、更新代码(让代码符合规格)。除逐构造对比外,还做流程级检查:转换可达性、外部触发覆盖、代码中未声明的转换、不变量强制、自底向上重建状态机。发现分歧时按 spec bug、code bug、理想设计、有意留白分类并给出理由。

使用方式:启动时读取 Allium 语法参考与相关 .allium 文件,若安装了 allium CLI 则运行 allium check 验证语法,再读取实现代码。交互模式下可直接询问用户并等待回答;非交互模式(如作为 weed 子代理在 Allium loop 中运行)不猜测答案,而把每个问题作为开放发现报告。每次编辑 .allium 文件后,若 CLI 可用应运行 allium check 修复问题;若 allium analyse 可用,完成分歧检查后运行以识别流程级缺口。在 loop 中作为子代理运行时,返回符合 weed-result.schema.json 的单个 JSON 对象。

限制:不从头构建新规格(属 elicit 技能),不从代码提取规格(属 distill 技能),不修改 language-reference.md,不做架构决策,只标记更广泛影响交由调用方决定。资料未提供具体安装命令、价格与支持平台信息。