SuperAPI AI 工具集

no-comments

编程与开发

查看项目

更新于 10-16 16:27

技能介绍

no-comments 是一个以技能文件形式组织的工具,来自 pstack-t3。其名称表明工作围绕代码注释展开。

用途与主要能力 根据资料,no-comments 的核心动作是“Spawn Comment Sicko”(启动一个名为 Comment Sicko 的委派子任务),然后对已接受的审查发现(accepted findings)进行修复,并针对被声明为约束的注释提供编码(encodings)方案。整体上它用于审查代码或差异中的注释,判断哪些注释应当删除、哪些约束注释应予保留,并对可执行的约束提出在类型、运行时、测试或 CI lint 层面的编码建议。

工作方式 技能文件说明,被加粗、加反引号或通过 /<name> 运行的技能,对应本技能目录旁的 ../<name>/SKILL.md,并应读取该文件并遵循。多数 pstack 技能仅限用户使用,技能工具无法加载它们。每次 delegate_task 调用都遵循 ../poteto-mode/SKILL.md 的 Subagents 章节中的默认设置。 处理范围使用调用者的文件或差异;否则使用当前相对基准分支(默认 main)的差异,包括工作区内容。 步骤上,它会在父任务的判断与行文模型下创建名为 Comment Sicko 的 delegate_task 子任务,其简报先原样粘贴 references/comment-sicko.md,然后是 how 与 why 的 SKILL.md 绝对路径,并附上“在运行 /how 或 /why 前先完整阅读该 SKILL.md 并遵循”的说明,最后是范围。子任务的推理级别与速度按 poteto-mode 技能的 Subagents 章节选择。 随后检查报告与差异,拒绝对应用代码的修改、范围逃逸、受异常保护的删除、对 MUST KILL 原因的误述,以及把有意保留的代码当作有罪的标记。可行动的标记需重塑。审计遗漏的范围化 lint 与 TypeScript 抑制。正确性或安全相关的抑制保持为可行动的 MUST KILL。删除的恢复只有在有精确异常与范围证明时进行。对单薄的 IMPORTANT 或 do not remove 的 kill/keep,需先对其符号运行 /how 或 /why。若 kill 含义不明则不恢复;若 keep 被反驳或仍含糊则删除。被拒绝的报告需在新的 delegate_task 中命名失败原因后重跑一次;第二次被拒则报告为 open 并令 /no-comments 失败。

修复方式 对于简单的已接受标记,直接删除死路径、去掉参数或改用真实 API。若修复需要形态设计,对已接受集合及周边代码运行一次 /architect,止于草图;architect 负责形态,第 4 步负责实现。在范围内实施最小根因修复,移除所有被点名的工作绕过(workaround)。若根因超出范围,则落地最小的范围内修复并将其余报告为 open。principle-fix-root-causes 与 principle-redesign-from-first-principles 技能仅指导意图,均不授权扩大围栏或在围栏外修复实例。不得附加症状性保护(symptom guards)。

约束处理 约束注释表示 do not remove、do not change wording 或 talk to X before changing。对无法更改之事的 keep 予以保留。提供最省成本的范围内类型、运行时、测试或 CI lint 编码。等待交互式批准;无人值守与评估场景需调用方预先批准。若获批准,则编码后删除;否则删除、将约束报告为 open,并勾画范围外工作。

报告内容 最终报告删除数量、恢复的注释、重跑、architect 草图、修复、编码提议、已编码项、未强制执行的约束,以及其他 open 工作。

适用场景与限制 适用于需要审查并清理代码注释、处理约束性注释、并可能将其转化为自动化检查的开发流程。限制包括:多数 pstack 技能仅限用户使用,技能工具无法加载;应用代码编辑被拒绝;范围外根因无法修复;症状性保护不被允许;约束编码需批准。关于收费、价格、平台与具体效果的资料暂未提供。