SuperAPI AI 工具集

structure-first

编程与开发

查看项目

更新于 10-16 07:57

技能介绍

用途:Structure First 用于代码生成、功能开发、缺陷修复、重构和代码审查,尤其当改动会新建或重塑多步流程、状态生命周期、决策与副作用归属、组合、迁移或边界契约时。

主要能力:其核心主张是“找到归属者,追踪流程,改动最小负责单元,验证契约”。它要求选择当前拥有该行为或规则的最小单元,而非只处理症状或输出;先说明意图与最小可观察完成条件;对缺陷先建立可观察的失败,再重构。追踪时只走从调用方经决策或状态、写入或效果到完成的必要路径,并使用代码本身自然的形式。只有在类型、测试、文档和配置不改会破坏行为、契约或有效验证时才一并处理。

使用方式:先命名结构需求(流程、生命周期、决策/效果/完成归属、组合、迁移或边界契约)以及阻碍追踪或测试的摩擦;优先做聚焦的局部澄清。仅当能降低总体复杂度或隔离可独立变更的职责时才改结构。每个决策、写入者、效果和完成规则应只有一条可发现、无竞争的解决路径;同一改动中移除旧的等价路径,否则需指明迁移归属者与退出条件。在稳定负责单元上验证可观察行为,而非辅助函数内部;证据表明契约部分属于其他单元时,只重开最小相关单元。保留、内联、合并、删除、重排、抽取以及不做结构改动都是有效结果。不要添加未来用途的选项、配置、依赖、包装或抽象。性能工作需在既有复现中测量输入规模、重复操作、物化与阶段耗时,在归属处移除主要可避免的工作,再用同一复现与可观察行为对比。

限制:资料未提供具体安装命令、平台支持、收费方式或价格信息。涉及公共 I/O、决策/写入者/效果/完成归属、异步或状态生命周期、表示含义或迁移路径时,需先阅读 Structural Boundaries;当重要主张跨越身份、权威数据、表示、外部写入或运行时/异步边界,或缺陷、重构、功能需要边界证据时,需阅读 Verification。报告当前单元、结构需求、所选结果、归属或迁移状态及验证,仅在有助于任务时进行,不要强行套用模板。