SuperAPI AI 工具集

finish-work

编程与开发

查看项目

更新于 10-16 01:16

技能介绍

用途:finish-work 是一个提交前(pre-commit)质量检查清单,用于在代码编写并测试完成后、提交之前,确认工作是否完整。它把交付定义为代码、文档、测试与验证的总和。

主要能力:清单分为若干部分。代码质量要求运行 pnpm lint、pnpm type-check、pnpm test,并检查无 console.log、无非空断言(x! 运算符)、无 any 类型。代码与规范同步要求检查 .trellis/spec/backend/、.trellis/spec/frontend/、.trellis/spec/guides/ 是否需要更新;若涉及基础设施或跨层契约,规范内容需可执行(真实签名/契约),包含文件路径、命令/API 名称、载荷字段名、校验与错误矩阵、Good/Base/Bad 案例以及所需测试与断言点,否则不得结束,需先手动运行 $update-spec。API 变更需更新输入/输出 schema、API 文档与客户端代码。数据库变更需创建迁移文件、更新 schema 文件、相关查询与种子数据。跨层验证需确认数据流、错误处理、类型一致性与加载状态。手动测试需在浏览器/应用中验证功能、边界情况、错误状态与刷新后表现。

使用方式:先运行 pnpm lint && pnpm type-check,再用 git status 与 git diff --name-only 查看变更,然后根据改动文件逐项核对清单。开发流程为:写代码 -> 测试 -> $finish-work -> git commit -> $record-session;调试流程为:遇到 bug -> 修复 -> $break-loop -> 知识沉淀。

适用场景:适用于使用 pnpm 的前后端项目在提交前做完整性检查,尤其涉及 API、数据库迁移或跨层改动时。

限制:资料未提供该技能的安装方式、收费、价格、平台支持或效果数据;清单中的命令与路径为项目约定,需按实际项目调整。