SuperAPI AI 工具集

feature-spec

编程与开发

查看项目

更新于 10-15 19:57

技能介绍

用途:为 Apify MCP server 规划并撰写新功能规格。该技能进入规划模式,探索代码库、设计功能,并产出 GitHub issue,全程不编辑文件。

主要能力:解析功能描述与可选仓库路径参数(--sdk、--ext-apps、--internal);按 flag 路径、默认同级路径、node_modules、GitHub URL 的顺序解析源码仓库;参考公共仓库、内部仓库、MCP SDK、MCP 规范、MCP Apps SDK 与规范、开发服务器等资源;遵循最小设计、复用优先、Zod 校验、HelperTools 枚举等约定;用 gh issue list 在三个仓库中查重,存在则用 gh issue edit 更新;按实现阶段拆分 issue,每个阶段约一个 PR 规模(约 50–200 行改动),使用 feature_spec.yml 模板,只保留有实际内容的小节。

使用方式:以 /feature-spec 加功能描述调用,可附加路径覆盖参数,例如 /feature-spec add resource links to dataset tools 或 /feature-spec --sdk ~/github/typescript-sdk add resource links。规划完成后退出规划模式,用 gh issue create 创建带 t-ai 标签的 issue,创建前先向用户展示内容供审阅。验证命令为 npm run type-check、npm run lint、npm run test:unit。

适用场景:在 Apify MCP server 上新增工具、资源链接、widget 支持等功能前的规格设计;需要评估对内部仓库影响、检查协议行为或交互式 UI 时。

限制:仅规划,不修改文件;功能描述含糊时应先提问澄清;涉及重构需拆为独立 PR 先行合并,不与功能改动混合;具体收费、价格、平台等信息暂未提供。