SuperAPI AI 工具集

skeleton

测试与质量

查看项目

更新于 10-15 22:12

技能介绍

用途:在新项目启动、编写任何功能之前,先搭建一个“可行走骨架”(Walking Skeleton,Cockburn 提出),即最薄的可运行系统,用来证明整条流水线可用:构建、测试、运行。输入为项目描述与技术栈($ARGUMENTS)。前置条件:必须已存在 concept capsule;若没有,应停止并建议先执行 /pragma:capsule。即使是最小 hello world 路径,也应使用术语表中的词汇。

主要能力与边界:骨架应做到项目可构建、测试运行器可运行且至少有一个通过的测试、一条最小路径端到端执行、capsule 中的 happy-path 场景有占位实现。它不是功能(无业务逻辑),不是架构(除单条路径所需外无分层或模式),也不追求全面(一条路径、一个测试、一个入口点)。

使用方式:1)项目脚手架:初始化项目、配置测试运行器、创建入口点;使用用户指定的技术栈,不得替换;采用最简配置,暂不加 linter、formatter 或 CI(这些留给 /pragma:harden);不安装不必要的依赖。2)一个通过的测试:单个测试证明流水线可用,从源码导入、断言一个平凡为真的条件、运行并确认通过;这是流水线测试而非功能测试。3)一条可运行路径:让入口点做最小且可观察的事——库则导出一个可从测试调用的函数;CLI 则接受简单输入并产生输出;服务器则启动、响应一个路由并关闭;UI 则渲染一个元素。触碰真实切片将跨越的边界,但逻辑保持平凡;若 capsule 有 happy path,则创建占位。4)验证并提交:运行所有可用检查(类型检查、测试、构建、运行入口点),在继续前修复,直到整条流水线为绿。

限制:无功能;无推测性结构(不为“以后”建目录、模块或抽象);不挑选依赖,只装运行所需,功能依赖随各自切片引入;测试必须真正运行并通过,入口点必须真正执行并产生输出。

输出:已证明的流水线(现在可做什么:构建、测试、运行)、入口点(做什么及如何调用)、测试(检查什么及如何运行)、创建的文件列表、下一步(通常是 /pragma:card → /pragma:slice 实现第一个真实行为)。生命周期:状态 foundation,下一步 /pragma:card,循环 /pragma:consult(默认,除非用户明确直接继续)。