SuperAPI AI 工具集

code-example-generator

通用与其它

查看项目

更新于 10-16 03:12

技能介绍

用途:该技能用于为教学场景生成“有教学效果”的代码示例,目标不是单纯演示语法,而是激活学习者理解。适用于编写课程示例、练习与讲解材料。

主要能力:提供 Persona + Questions + Principles 的推理式工作框架;包含五组系统追问(规格优先验证、熟练度定位、教学范式选择、双语判断、验证规划);给出 7 条决策原则:规格优先于代码、先展示后解释、每个示例只教一个概念、贴近生产而非玩具示例、可运行且经测试、概念通用时双语/语言特有则单语、由简到繁递进;并设有 5 个收敛点自查(如“待办应用综合征”、无上下文的语法、多概念混合、跳过验证、先解释后展示)。还包含与 learning-objectives、concept-scaffolding 等技能的集成建议。

使用方式:调用该技能,输入类似“为 B1 中级学习者生成 Python 装饰器示例”的需求,技能会按 Spec→Prompt→Code→Validation 流程产出代码,并附测试用例。资料提及 validate-syntax.py 与 sandbox-executor.py 用于语法与执行验证,但未提供具体安装或调用命令。

适用场景:编程教学示例编写、课程章节示例、学习目标对齐的练习设计。

限制:资料未提供价格、平台、依赖安装方式等信息;具体验证脚本的运行方式、可用环境暂未提供。