SuperAPI AI 工具集

setting-up-a-project

编程与开发

查看项目

更新于 10-27 00:56

技能介绍

用途

该技能是项目规格化设置的调度入口,用于将尚未建立规格图谱的项目转化为规格图谱。它适用于被要求设置、入驻、初始化或为项目编写规格说明的场景,也可由应用内的「Set-up-project」卡片触发。资料明确说明,它不用于普通项目工作。

主要能力

  1. 检测现状:使用 spec_grep / spec_graph 工具检查工作区,判断是否已存在规格图谱(如 goal-and-requirements.md 或任意 SPEC.md),以及仓库中是否有真实源代码,还是空仓库或近似空仓库(仅有 README 或脚手架)。
  2. 路由处理:根据检测结果将用户引导至匹配的流程,避免自行发挥流程。
    • 已有规格:不重做,简要提供审查或扩展图谱的选项,例如补充缺失的 architecture.md 或未规格化的模块。其他工作按常规路由:功能、行为变更和缺陷修复通过头脑风暴;不改变行为的工作直接进行。用户拒绝则停止;接受则进入图谱扩展。
    • 无规格且仓库为空或近似空:转交 starting-a-new-project 技能,通过访谈将想法转化为 goal-and-requirements.md。
    • 无规格但已有真实源代码:转交 importing-a-codebase 技能,分析代码与代理文件,草拟首版规格图谱,仅询问代码无法揭示的意图。
  3. 图谱扩展:没有专门技能覆盖扩展现有图谱。若用户接受扩展选项,则依据自身判断对齐并适应用户请求,遵循 writing-specs 标准,不进行路由宣告。

使用方式

按照资料描述,先执行检测步骤,再根据所处情况阅读并遵循对应技能的步骤,不自行即兴设计流程。该技能以点名以下之一结束:starting-a-new-project、importing-a-codebase,或在已有规格时给出审查/扩展选项(拒绝则停止;接受则按 writing-specs 标准进行图谱扩展)。

适用场景

  • 项目没有任何规格图谱,需要初始化规格化流程。
  • 仓库为空或近似空,需要从想法开始建立目标与需求文档。
  • 已有真实源代码但缺少规格,需要从代码导入并草拟首版规格图谱。
  • 已有规格图谱,需要审查或扩展。

限制

资料未提供该技能的收费、价格、平台兼容性、效果保证或具体安装步骤。该技能本身不直接执行项目设置,而是负责检测与路由;具体设置步骤由所指向的技能定义。图谱扩展没有专门技能,需依赖判断并遵循 writing-specs 标准。