SuperAPI AI 工具集

prototype

编程与开发

查看项目

更新于 10-16 09:54

技能介绍

用途:在完整实现前,以最少代码验证技术可行性,回答一个原子问题(以“Can I...”开头),最大限度获取学习成果。

主要能力:提供六阶段强制清单,每阶段设有关卡,必须完成才能进入下一阶段。Phase 1 SCOPE:向用户询问“What ONE thing are you trying to prove?”,不断收窄至原子问题并声明范围。Phase 2 CONTEXT:用 git branch --show-current 检查分支,若在 main/master 则执行 git checkout -b prototype/<scope-slug>;调用 Skill(code-foundations:aposd-reviewing-module-design) 调研现有代码,声明环境摘要。Phase 3 MINIMUM:调用 Skill(code-foundations:cc-pseudocode-programming) 写3-5行仅含 happy path 的伪代码,无错误处理、无边界情况、无验证,若预计超过50行则重新收窄范围。

使用方式:Phase 4 EXECUTE 将伪代码逐行翻译为代码,文件头必须加 // PROTOTYPE: [scope] // NOT PRODUCTION 注释,运行并记录结果。Phase 5 VERIFY 给出 YES/NO/PARTIAL 的二元判定;PARTIAL 时列出 WORKS、BLOCKED、UNCLEAR。Phase 6 CAPTURE 执行 mkdir -p docs/prototypes,写入 docs/prototypes/YYYY-MM-DD-<scope-slug>.md 日志,最后用 git add . && git commit -m "prototype: [scope] - [YES/NO/PARTIAL]" 提交。

适用场景:需要快速验证某个技术点是否可行、集成是否可用、接口能否调通时使用。

限制:仅含 happy path,不包含错误处理、输入验证和边界情况,明确标注为非生产代码;必须在独立分支操作,不可在 main/master 上写代码;伪代码未获批准前不得写真实代码;不记录则视为无效。该技能依赖两个必选子技能:aposd-reviewing-module-design 和 cc-pseudocode-programming。