SuperAPI AI 工具集

coding-fingerprint-wizard

编程与开发

查看项目

更新于 10-16 00:29

技能介绍

用途:从若干示例项目出发,合成一份可复用的“编码指纹”,即识别一个人在其作品中有辨识度的工程决策,而非格式器细节或通用的“整洁代码”建议。适用的目标包括:编码风格、工程原则、仓库组织偏好、架构倾向、测试与验证习惯、抽象阈值。不适用于表层风格分析、格式器模仿或单个项目的盲目崇拜。

主要能力:采用严格的“发散—收敛”流程。阶段0准备:先建立样本清单,记录范围、样本、证据质量与注意事项,写入 _working/coding-fingerprint/ 并遵循分析工作表契约。阶段1发现:并行运行子代理,默认每个项目一个 worker 生成 project-profile-<slug>.md,项目大时可增加测试、架构、审查风格或错误处理等视角 worker,先收集广度证据。阶段2定义:在项目画像完成后运行综合 worker,只有跨项目出现或周边证据强有力的模式才提升;区分持久指纹特征、上下文相关选择、矛盾与开放问题;仓库塑造被视为一等输出。阶段3开发:对草稿指纹做压力测试,至少挑战对单个项目的过拟合、作者一贯不做的事、独立分析者间的可复现性、对可能实现选择的预测力。阶段4交付:使用 references/fingerprint-template.md 生成最终技能,保存为 coding-fingerprint-[name]/SKILL.md。阶段5验证:用仅能访问生成指纹的新子代理执行一个小型代表性任务,对比其选择与源项目,若结果泛泛、与证据矛盾、过拟合单个代码库、只有风格没有原则或无法被其他代理可靠应用,则加以改进。

使用方式:顶层代理充当协调者,为详细分析生成子代理,独立工作可并行;以 references/analysis-worksheet.md 作为产物契约的唯一来源;决定证据何时足够收敛;解决 worker 输出冲突;除非在调和分歧、修复失败交接或验证最终结果,协调者不应亲自做全部分析。阅读顺序:先读 SKILL.md,再读 references/REFERENCE.md 以有选择地决定下一个文件;创建或检查任何 _working/coding-fingerprint/ 产物前读 references/analysis-worksheet.md;阶段4开始时才读 references/fingerprint-template.md;仅当输出形态不清晰或需要校准时才读 references/example-coding-fingerprint.md。

样本质量:优先选择2-5个有真实作者信号的样本。强样本通常包含有意义代码而非生成脚手架,有测试、文档、提交历史或审查上下文,年代与职责级别相近,且作者至今仍会认可。弱样本通常包括高度模板化的仓库、行为信号很少的一次性实验、作者身份不明团队代码、被框架默认值主导的仓库。若样本混合了差异很大的上下文,需明确记录,并将上下文相关模式视为较弱证据。

信号质量:优先高信号模式。强信号包括验证所在位置、边界如何划定、边界出现后仓库如何拆分、什么被抽象而非复制、什么被生成而非手写、测试如何表达意图、偏好的错误语义、围绕重要契约的文档/CI/漂移检查习惯、揭示领域建模的命名选择。弱信号包括格式器输出、无可选择余地的语言默认值、孤立的炫技代码、框架样板。

限制与质量门槛:应避免把指纹简化为风格指南陈词、把单个出色项目当作整个人、把生态约束混为个人偏好、无证据地推断原则、产出其他代理无法操作的指纹、因为综合看起来正确而跳过挑战阶段。最终指纹的合格标准是能帮助其他代理回答:此人会如何拆分模块、如何塑造仓库或工作区、在哪里验证输入、先测试什么、期望存在哪些文档/模式/CI 检查、会拒绝哪种过早抽象、会立刻指出什么代码异味。若无法回答,则指纹仍过于模糊。

相关技能:需要本流程之外的草稿笔记时用 working-docs;用实现任务验证生成的指纹时用 test-driven-development。