SuperAPI AI 工具集

ship-checklist

通用与其它

查看项目

更新于 10-16 01:34

技能介绍

用途:在向 ax 图谱提交新的写入、信号、表、边或查询前,用这份完成度定义清单逐项核对,尤其用于提交 PR 之前。其核心主张是:ax 的自我改进循环依赖智能体主动发现并处理信号,因此一个新的写入必须让智能体在无需被告知的情况下也能找到它才算完成。

组织规则:每个写入都需要 (B) 按需读取、(C) 主动读取,以及面向智能体的界面(MCP/技能)。多数功能只做到 A+B 就停止,这是反复出现的遗漏:只做了写入和按需 CLI 读取,跳过了主动的、面向智能体的读取;仅在手动 CLI 运行中可见的信号对自我改进循环而言是隐形的。

主要能力(清单分六组): A. 写入:schema.surql 中建 schema 并在 SCHEMA_TABLES 注册(CI 镜像守卫);摄取需幂等、增量(感知 since)、读取用去引用式反规范化(聚合内不做记录解引用,会挂住生产);考虑回填——历史数据是否获得该信号,若否须注明“重新摄取前为暗态”;阶段依赖等于输入表的所有生产者。 B. 按需读取:CLI 命令或现有命令的一个 facet(保持家族一致);--json 信封以便脚本处理;如有可视需求则提供仪表盘/studio 界面。 C. 主动读取(最常被漏掉的一半):提供 MCP 工具使智能体可在上下文中查询(apps/axctl/src/mcp/tools.ts);接入 ax improve recommend 生成器,在信号跨过阈值时生成建议(智能体无需提示即获得建议);接入 ax insights / dashboard 的 next-actions(若该信号隐含动作);若夜间循环应处理,加入 dojo agenda 条目;编写技能,用认知模式教会智能体对信号采取行动(如 ln 技能据 ax 成本图像把视觉判断路由给子智能体)。 D. 文档:CLAUDE.md 的命令/章节文档(新子命令有文档门禁);面向用户时更新 llms.txt、站点文档或 README;CHANGELOG 与发布说明(release-please);非平凡特性在 docs/superpowers/specs/ 写规格。 E. 入门与分发:入门提示(@ax/onboarding-prompt)——第 1 天的用户/智能体是否应知道它存在;面向用户的能力考虑营销覆盖(站点页面/博客/X);如相关则加 /api/version 能力标志。 F. 验证(要证据而非断言):对纯辅助函数写单元测试,加 schema 镜像守卫和 CLI 命令列表测试;针对真实数据库做实时验证,并在 PR 中粘贴实际输出;“无数据即暗态”如实说明:若需回填/遥测才能点亮,要写明。

使用方式:为每个相关行创建 TodoWrite 项,或把 A–F 标题粘贴进 PR 正文作为勾选清单。跳过某行可以,但要在 PR 中说明跳过的原因,不要默默跳过。

限制:该技能是流程清单,本身不提供除上述命令与路径外的自动执行能力;具体功能、收费、价格、平台与效果资料未提供。