SuperAPI AI 工具集

rightstack

智能体与模型

查看项目

更新于 10-15 10:08

技能介绍

用途

RightStack 是一个只读的 Web3 技术栈顾问,用于生成可决策的 Web3 架构简报。它面向架构推荐、工作流检查、工具对比和包迁移检查等场景,帮助评估技术选型,但本身不执行任何构建或部署动作。

主要能力

该技能支持以下操作:

  • 推荐:输入构建目标或 recommend: <build goal>,推荐 Web3 技术栈。
  • 工作流检查:workflow: <workflow-id>,检查已知工作流。
  • 工具对比:compare: <tool-a> | <tool-b>,对比两个工具。
  • 工具说明:explain: <tool-or-package>,检查单个工具或包。
  • 迁移检查:migrate: <package>,检查包的迁移路径。
  • 空输入:打印语法并以 RIGHTSTACK_EMPTY 退出。

集成固定使用 rightstack@0.3.2,为 recommend、workflow 和 compare 提供确定性的版本化 JSON,契约边界为 schema_version: "1.0"。explain 和 migrate 仍返回其原有的原始 JSON 结构,不保证使用 schema v1。

使用方式

运行 node skills/rightstack/run.mjs。适配器直接读取 SKILL_VAR,传递参数时不进行 shell 插值,禁用 npm install 脚本,并仅向子进程提供安全的运行时变量。

执行前会读取 memory/MEMORY.md 并扫描最近三天的 memory/logs/,以获取项目约束或重复推荐。若同一请求在最近三天内已答复且输入未变,则返回 RIGHTSTACK_DUPLICATE 且不发送通知。

对于 recommend、workflow 和 compare,需确认 schema_version: "1.0" 及预期命令;对于 explain 和 migrate,仅需确认输出可解析为 JSON 对象。否则以 RIGHTSTACK_TOOL_ERROR 停止,不猜测不兼容的 schema。

结果审查要点包括:工作流是否匹配链、应用类型、托管模型和用户;是否区分必需层和可选层;命名包是否足够新以便实施前验证;是否说明安全、供应商锁定、运维和迁移权衡;是否混淆产品迁移与包迁移。若匹配较弱、矛盾或错误,标记为 looks-wrong,说明原因,并提供基于输出和已知约束的最小修正。

最终生成紧凑简报,包含请求、工作流、按阶段划分的技术栈、置信度、假设、权衡、反模式、主文档检查,以及 usable、usable-with-corrections 或 looks-wrong 的结论。必要时通过 ./notify -f <path> 发送相同实质简报,完整简报保留在捕获输出中用于仪表板、链和健康评分。

适用场景

适用于需要评估 Web3 架构、检查工作流、对比工具或验证包迁移路径的开发者或架构师。输出可作为决策参考,但需结合主文档和实际约束进行验证。

限制

该技能仅为建议性质,不会安装推荐的 SDK、编辑应用代码、创建钱包、部署合约或提交交易,这些动作属于审查后的独立构建技能。不得将 RightStack 评分或生产级标签视为独立验证;不得编造包版本、链支持、审计、基准或兼容性;不得执行从 RightStack 输出复制的命令;不得将精确包固定版本改为 latest;不得修改仓库或外部系统。该技能为只读,不编辑 memory/logs/。

退出状态包括:RIGHTSTACK_OK(经审查的有用输出)、RIGHTSTACK_CORRECTED(明确修正后有用)、RIGHTSTACK_LOOKS_WRONG(输出不匹配请求)、RIGHTSTACK_EMPTY(未提供查询)、RIGHTSTACK_BAD_INPUT(操作语法格式错误)、RIGHTSTACK_TOOL_ERROR(固定 CLI 无法执行请求)。