SuperAPI AI 工具集

write-feature

编程与开发

查看项目

更新于 10-15 22:41

技能介绍

用途:write-feature 用于实现“新增能力”类任务,即在任务包(task packet)要求下构建此前不存在的功能行为。它不适用于修缺陷、无行为变化的重构、有意改变既有行为、API 迁移或性能调优,这些属于该库中其他指南。

主要能力与规则:先读任务包及其来源,任务包确定范围(AC 列表、禁止改动区域、Verify 清单),规范说明原因;项目命令从代码仓库的 AGENTS.md Commands 表解析,未定义则询问,不得猜测。编码前把每条 AC 映射到改动的具体部分,每条 AC 在计划中有具名步骤。新增 helper、类型或模式前先搜索代码库中已有等价物,记忆不算调研;若无合适者,在总结中说明原因。AC 不清晰或矛盾时停下上报,不得臆造需求。不得顺手重构,构建中发现的债务记为 finding 候选。每批改动后运行检查并粘贴输出,而非只在最后。测试属于交付物,每条 AC 对应测试(或明确记录的后续任务),并通过翻转断言(或注释掉被测生产路径)证明测试有效:翻转须失败,恢复须通过,粘贴两次转变。每个 Verify 项在最终编辑后粘贴真实输出(命令、退出状态、摘要行,原样围栏)。结尾给出总结与发现:改动文件、命令及输出、未满足项、越界编辑、## Findings 中的候选;不对自己的工作给出评审结论。

使用方式:开始前打开 references/task-template.md 作为工作文件,它提供 AC 到改动的映射、批次检查点、粘贴证据与自评的脚手架,随做随填。任务包本身使用该套件的任务模板。

限制:这些是评审包检查的约定,编辑时并无强制机制。自评门要求:每条 AC 对应可指出的 diff 部分,且 diff 无无 AC 支撑的部分;每个 Verify 项在最终编辑后运行并粘贴输出;每个新测试翻转后失败、恢复后通过并粘贴代表性转变;所有歧义已上报而非猜测解决;新 helper 或模式记录既有方案不适用的原因;总结列出改动文件、命令输出与 finding 候选,且不自行给出评审结果。

其他事实(如收费、平台支持、安装命令)暂未提供。