SuperAPI AI 工具集

skeleton-spike

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

用途

skeleton-spike 用于在架构落地前做“管道验证”。当系统被拆分为多个模块或限界上下文时,单模块可运行并不代表集成可行;本技能通过搭建一个最小端到端行走骨架,证明模块间连接是否真正成立,从而在投入详细实现前暴露集成风险。

主要能力

  1. 细追踪器约束:骨架只传输最小 dummy 载荷(ping-pong tracer),禁止在骨架内实现复杂业务逻辑。
  2. 全接缝遍历:骨架须经过完整端到端管线——输入端口 → 适配器 → 序列化 → 传输/总线 → 目标模块 → 持久化桩。
  3. 管道验证维度:覆盖依赖注入接线、限界上下文之间的模式与序列化兼容性、端口绑定,以及 HTTP、gRPC、事件总线等模块间通信协议。
  4. 状态判定:给出 CONFIRMED(端到端追踪成功且集成断言通过)、INFERRED(追踪部分成功,依赖模拟传输或未验证的运行时假设)、REJECTED(协议不兼容、序列化失败或运行时阻塞)或 UNRESOLVED(环境限制或缺少权限导致无法端到端执行)。
  5. 输出契约:生成结构化证明报告,包含结论、经过的追踪路径、受约束的冻结接口契约、执行证据(测试目录、验证命令、遥测输出)与边界发现;同时为自主运行器输出集成状态微令牌。
  6. 路由建议:CONFIRMED 后进入切片实现(/split-tasks);管道被拒绝则走 /architect-decision;契约不匹配走 /contract-freeze;运行时或依赖未就绪走 /env-doctor。

使用方式

在 .agents/scratch/ 或 git worktree 中,依据目标冻结契约脚手架最小骨架,接入传输、序列化与持久化桩,使用 dummy ping 载荷;执行集成运行命令,确认完整遍历后,按 Canonical Proof Report 格式或微令牌格式汇报结论。探索性代码须严格限制在指定目录,运行器与服务需记录于 .agents/environment.md,不得污染主分支历史。

适用场景

适用于多模块系统或限界上下文架构在开发早期的集成可行性验证,尤其是需要确认跨模块通信协议、序列化兼容性与依赖注入接线是否成立的场合。

限制

资料未提供具体技术栈、环境要求、权限配置或实现细节,这些内容暂未提供;技能不用于实现业务功能,仅做骨架级管道证明。