SuperAPI AI 工具集

create-project

办公与效率

查看项目

更新于 10-15 10:26

技能介绍

用途

create-project 用于创建一个新项目,并在创建过程中进行协作式规划。当用户想要启动一件有明确交付终点的新任务时,可加载该技能。它的核心流程是:先由脚本生成项目结构,然后由 AI 引导逐步填充规划文档。

主要能力

结构生成

运行 scripts/init_project.py 后立即生成项目结构:

  • 4 个目录:01-planning/、02-resources/、03-working/、04-outputs/
  • 3 个规划文件(位于 01-planning/):overview.md、plan.md、steps.md
  • 自动分配下一个可用的项目 ID

使用方式:python scripts/init_project.py "Project Name" --path 02-projects

自适应规划

项目类型选择包括 Build、Research、Strategy、Content、Process、Generic。模板会根据项目类型扩展相应章节,例如选择 Build/Create 时会加入 Technical Architecture、Implementation Strategy、Integration Points 等章节。

深度思考

在填写 plan.md 时,AI 会应用思维模型,包括苏格拉底式提问(用于 Approach 部分)与魔鬼代言人(用于风险评估)。思维模型的选择必须遵循脚本优先的流程:

  1. 先运行 python 00-system/mental-models/scripts/select_mental_models.py --format brief
  2. 脚本输出 JSON 数组,包含 12 个类别下的 59 个可用模型
  3. AI 根据项目类型与上下文,向用户提供 2-3 个相关模型选项(描述为 3-7 个词)
  4. 等待用户选择(或选择不使用)
  5. 用户选定后,再加载对应的单个模型文件,路径形如 00-system/mental-models/models/{category}/{model-slug}.md,例如 00-system/mental-models/models/cognitive/first-principles.md

该环节不允许跳过脚本、不允许凭记忆直接应用模型、不允许自动替用户选择。

依赖研究

在完成 plan.md 之前,AI 会自动执行依赖研究:

  • 使用 codebase_search 扫描引用相同领域的文件
  • 查找可复用的现有技能
  • 识别外部系统配置(MCP 服务器、Airtable schema、Slack 频道)
  • 将具体文件路径与系统名称写入 Dependencies & Links 章节

强制暂停

每完成一份规划文档(overview.md、plan.md、steps.md)都要暂停,等待用户确认后再继续下一份。

独立会话原则

项目在当前会话创建并完成规划,执行则在另一个会话中进行,以保持上下文边界清晰,并通过 close-session 保存状态。

使用方式

入门引导检查

在创建项目之前,AI 必须检查 user-config.yaml 中是否存在未完成的引导项。若 learning_tracker 中的 learn_projects 为 false,且这是用户的第一个项目,则建议先运行 learn projects 技能(约 8 分钟教程);用户若说 skip,则继续创建,并在结尾提示可稍后运行 learn projects。若 learn_projects 已为 true,则正常进行,不做提示。

模式识别

开始任何工作流之前必须先判断模式:

  • 存在 02-projects/ → 项目创建模式(PROJECT_CREATION),完整协作规划约 20-30 分钟
  • 不存在 02-projects/ → 工作区搭建模式(WORKSPACE_SETUP),创建初始工作区目录结构约 10-15 分钟

执行步骤

  1. 创建 TodoWrite,列出所有步骤
  2. 提供项目类型选择
  3. 询问项目名称
  4. 立即运行 init_project.py
  5. 展示生成的结构
  6. 加载 overview.md,协作填写,暂停等待确认
  7. 加载 plan.md,应用思维模型,研究依赖,暂停等待确认
  8. 加载 steps.md,拆分执行步骤,暂停等待确认
  9. 关闭会话

反模式(不应出现):跳过项目类型选择、跳过运行 init_project.py、手工创建文件、结构未生成前生成内容、跳过思维模型提问、跳过依赖研究、跳过文档间的暂停、在单次回复中完成整个技能。

适用场景

适用于需要启动一个有明确交付终点的新任务,并希望先进行结构化、有深度的规划再进入执行的场景。用户通过关键词如 create project、new project、start project、plan 触发。项目类型覆盖 Build、Research、Strategy、Content、Process、Generic。

限制与错误处理

  • 无效的项目 ID 或名称:说明校验规则、给出正确格式示例并建议修改
  • 项目已存在:告知用户,提供改名、改 ID 或加载已有项目等选项
  • 记忆文件缺失:提示“Memory files not initialized”,建议先运行 00-setup-memory project,并且不创建项目
  • 用户中途放弃:将部分工作保存到临时文件,提示可用“continue project creation”继续
  • 用户跳过审阅:提醒其重要性,并温和坚持先审阅再继续

集成关系

close-session 会在每次会话后自动更新 project-map.md;validate-system 会检查项目结构完整性;其他技能可在其工作流中引用项目产出。

相关文件

  • scripts/init_project.py:项目模板快速生成器
  • references/project-types.md:项目类型与自适应规划指南
  • references/workflows.md:两种模式的完整交互式规划工作流(含 #workspace-setup 与 #project-creation)
  • references/mental-models.md:完整思维模型目录
  • references/project-schema.yaml:YAML frontmatter schema 文档

平台与收费

资料中未提供关于官方平台、定价或收费方式的信息。