SuperAPI AI 工具集

start-project

编程与开发

查看项目

更新于 10-16 10:07

技能介绍

用途

start-project 面向完全不懂编程和工程的初学者,帮助其挑选并界定第一个真实项目。其核心理念是:项目是学习的锚点,概念只有附着在学习者真正在意的事情上才会牢固。该技能不编写任何应用代码,而是通过与学习者对话,找到这个锚点、把控项目规模,并勾勒出需要掌握的知识地图。

主要能力

  • 访谈学习者:分四个广度性问题了解学习者一天的工作、最近一个工作日的时间线、重复性事务、业余时间的花费及是否有他人参与;再以三个问题了解其编程经验、是否用过终端、学习动机;随后选择一个信息最丰富的线索深入追问二至四轮;最后询问每周可实际投入的小时数。
  • 提出并定规模:基于访谈内容给出 2–3 个项目点子,每个包含一句话说明它是什么、一句话说明为何契合其生活、一句话说明为何规模合适。目标为“有挑战但不压倒”,应尽早可见成果、触及真实的端到端技术栈,并在数周内可用。
  • 界定 MVP:将设想的全部功能拆分为“MVP 内”和“停车坪(v2)”两份清单,并抵制 MVP 膨胀。
  • 构建主干:列出项目从无到部署所需的核心组件,每个组件给出名称、通俗解释和为何需要,通常保持 5–9 个组件,且始终包含版本控制(git)、代码运行位置、组件间通信方式与部署。
  • 记录成果:生成 learning/project.md,包含“关于我”“点子”“MVP”“主干——核心组件”等章节。
  • 衔接下一步:提示运行 /plan-journey,将主干转化为面向学习的逐步构建计划。

使用方式

该技能在多种宿主中调用。在 Cursor 桌面端与终端中,调用共享技能 /begin、/connect、/status、/next-lesson(名称冲突时在技能选择器中选择 Altitude);文件中的 /altitude:<skill> 示例在 Cursor 中译为 /<skill>,Claude Code 保留 /altitude:<skill>,Codex 保留 $<skill>。在 GitHub Copilot CLI 与 VS Code Copilot 聊天中,同样使用共享的 Altitude 技能,在宿主的技能选择器中按名称选取,并使用宿主显示的调用写法;不要将这些文件复制成第二个仅限 Copilot 的技能库。完整 Altitude 插件提供课程钩子,单独复制技能仅提供独立的免费方法。

交互规则

假设学习者对代码和工程一无所知,首次使用任何技术名词时都要用平实语言解释;一次只问一个问题,等待回答后再问下一个;消息保持简短。回答与理解检验由学习者在聊天中用自己的话给出,不使用会替学习者说话或让检验可猜测的多选题面板;只有当学习者确实在若干具名选项间做选择(如挑选项目点子)时,面板才适用。理解检验应向前探测而非复述刚发送的内容,例如询问预测、应用或后果:缺少某部分会怎样、某部分需与谁通信、最先会看到什么。问题未解决前不要结束——若学习者最新消息包含提问,或理解检验答错或不完整,应先回应再收尾。

适用场景

适合希望开始第一个真实编程项目、但脑中尚无清晰想法或不知如何控制规模的完全初学者;学习者只需描述自己的日常与兴趣,由技能负责构思项目。若用户已自带点子,仍应收集其日常、兴趣与可用时间,但流程可加快、跳过点子已覆盖的问题,并在第二阶段评估其点子规模而非另提新点子。

限制

若当前目录已存在 learning/project.md,技能会先总结并询问是继续该项目还是重新开始(重新开始需将旧文件归档至 learning/archive/)。若目录中已有真实代码库(多于一个 learning/ 文件夹),这属于“采纳”而非全新开始,会指向 /adopt-project;例外情况是用户从 /adopt-project 带着“以参考重建”的决定而来,此时继续,并将旧仓库视为规格说明。该技能不写任何应用代码,不涉及实现细节与代码,只做高层梳理。至于价格、收费、平台或效果等事实,资料未提供。