SuperAPI AI 工具集

learning-curriculum

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:将真实代码库写成面向新手的课程,使读者能从空文件夹重建同一项目,并带走工程习惯(垂直切片、调用方拥有接口、context、最廉价假件),而非仅做代码导览。与 reverse-architect(知识地图)、systems-analyst(可观测性缺口)不同,本技能教人构建系统。

主要能力:按流程产出 learning/ 目录,含 README、00-mindset.md 及若干工具章节,最后是重建手册。工具章节结构为:痛点、本仓库做法(真实类型与路径)、不该做什么(含仓库自身缺陷)、练习。重建手册按阶段给出要建文件、检查清单与“先学”链接。

使用方式:先运行扫描脚本清点仓库,运行 bash /mnt/skills/user/learning-curriculum/scripts/scan-repo.sh [project-root];再用 bash /mnt/skills/user/learning-curriculum/scripts/scaffold-curriculum.sh --out learning --topics mindset,layers,rebuild 创建桩文件。--out 指定输出目录(默认 learning),--topics 为逗号分隔的桩名。填写桩时参考 references/curriculum-template.md,初稿前读 references/anti-patterns.md。

适用场景:用户要求学习文档、课程、重建指南时;用户点名要教的主题(框架、分层、日志、测试与 mock、OTel、SQL、DI、context)。文档语言跟随用户最新消息,代码标识符保持英文。

限制:若用户想要的是当前代码导览,应改用 reverse-architect 或 systems-analyst;不要为 CLI 编造 Gin 课程。仓库缺少 OpenAPI 或 Gin 时,替换为真实契约与框架。不得把整个源文件贴进 markdown,长模板放 references/。仓库是答案,切片测试通过或卡住 20 分钟后才允许偷看。结尾固定提示:先读 0–N 工具章节,再读重建。其他事实暂未提供。