SuperAPI AI 工具集

project-init

智能体与模型

查看项目

更新于 10-15 10:17

技能介绍

用途

project-init 用于把一个新的机器学习研究项目初始化为“控制根”(control root),而不仅仅是创建两个并列的仓库。当用户希望智能体从 <ProjectName>/ 目录出发工作,同时让 paper/、code/ 以及可选的 slides/ 保持为相互独立的组件仓库时,适合使用本技能。

主要能力

  • 创建控制根目录结构,包括 memory/、docs/(overview.md、designs/、experiments/、updates/、audits/、timelines/)、reference/(.agent/runs/、sources/、cards/、project-use/、notes/、summaries/)、reviewer/.agent/、rebuttal/.agent/、artifact/.agent/、.uv-envs/、code-worktrees/、paper-worktrees/。
  • 可选创建 slides/ 组件。
  • 可选初始化根 Git 仓库,并提供忽略组件仓库与工作树的根 .gitignore 内容。
  • 可选创建或关联 GitHub Project 看板,并给出 gh project 命令模式与推荐字段、视图。
  • 引导项目记忆文件,包括 project.yaml、component-index.yaml、current-status.md、decision-log.md、claim-board.md、evidence-board.md、provenance-board.md、risk-board.md、action-board.md、handoff-board.md、phase-dashboard.md、source-visibility-board.md。
  • 写入根级 AGENTS.md 与 CLAUDE.md 智能体指引,并保持两者语义一致。
  • 记录默认工具链门禁(toolchain gates),覆盖代码、论文与协调流程。

使用方式

技能按步骤执行:

  1. 收集项目信息:项目名称与父目录、研究摘要(方法思路、目标问题、数据集、基线、指标、成熟度)、目标会议或里程碑、组件选择(paper/code/slides/reference/reviewer/rebuttal/artifact 各自新建、连接已有或跳过)、Git 策略(根仓库是否启用、组件远端、是否使用子模块、是否创建 GitHub/GitLab 仓库、是否创建或关联 GitHub Project 看板、是否启用默认工具链门禁)、工作树策略(默认同级根 code-worktrees/ 与 paper-worktrees/、共享 uv 环境路径、服务器工作树根、分支命名约定)、论文源码可见性策略。需等待用户回答后再创建文件。
  2. 创建控制根:按上述目录结构创建,可选 slides/;如启用根 Git 则初始化并添加 .gitignore;如需创建托管仓库先检查 gh auth status;如需 GitHub Project 看板则先确认 owner 并检查认证与 project scope。
  3. 引导项目记忆:使用 research-project-memory 模板或等价文件创建各记忆文件,并在 component-index 中记录各组件路径、工作树根、工作树索引路径、共享 uv 环境与职责;在 project.yaml 中记录工具链门禁与可选的 github_project 配置。
  4. 创建根级智能体指引:写入 AGENTS.md 与 CLAUDE.md,说明智能体从 <ProjectName>/ 出发、使用 git -C 操作组件仓库、工作树位置、论文源码可见性层级、代码与论文门禁命令等。

适用场景

  • 需要以控制根方式组织机器学习研究项目,让 paper/、code/、slides/ 作为独立组件仓库协作。
  • 需要跨组件共享记忆、决策日志、证据板与交接板。
  • 需要为智能体提供统一的项目级指引与工具链门禁策略。
  • 需要可选地对接 GitHub Project 进行协作协调。

限制

  • 技能文本明确要求先收集用户回答再创建文件,不应在信息缺失时擅自创建。
  • 根 Git 为可选;若启用,不应意外提交嵌套组件仓库,除非用户明确希望使用子模块。
  • GitHub Project 为可选云协调,不替代根 memory/、组件 .agent/ 或仓库原生证据文档。
  • 不应把私有研究理由或隐藏的论文评审风险镜像到 GitHub 字段,除非用户明确希望这些材料可见。
  • 连接已有仓库时应保留其现有组件专用工具,而非强制套用默认脚手架策略;非 ML 仓库应省略不存在的默认路径。
  • 关于收费、价格、平台支持范围等事实,资料中暂未提供。