SuperAPI AI 工具集

greenfield-project-scaffolding

编程与开发

查看项目

更新于 10-15 17:19

技能介绍

用途:在首次写入前为新项目选定项目根目录与常规布局,适用于全新项目的脚手架搭建,不适用于已有仓库、项目、笔记本、缺陷修复、仓库维护或仅组件级修改。

触发条件(三道门同时成立):当前同一用户轮次明确出现开始、实现、构建、脚手架或继续新项目等即时实施措辞;即使用户回答了先前问题、处于规划决策轮次或提醒尚有工作,只要没有这些实施措辞,都不算授权,应停止且不写入文件。若产品行为或交付约束缺失、明显截断或实质歧义,只问一个聚焦的澄清问题并停止,直到回答消除缺口。不能仅因交付物是应用或游戏就调用本工作流。

根目录选择:在把位置视为未知前先解析显式位置。here、this folder、当前文件夹、当前目录仅在允许的事实确认当前目录适合作为目标项目根时才算目标;类似家目录、通用目录或假空目录不会因指示性措辞变得合适。保留显式命名路径和已存在的项目根。存在性仓库、项目或笔记本仍被排除。

检查限制:用户禁止检查现有文件时须遵守,只用请求、pwd 和路径语义,不列出或读取邻近内容;显式禁止查看导致位置无法确定时,依据请求与路径语义创建有意义的专用子目录,并跳过后续发现步骤。

否则复用触发本工作流的允许检查:使用请求、pwd、已观察的顶层条目和项目标记,不重复已完成的读取,只检查仍缺失且用户允许的位置事实。判断用户是否指定目标、当前目录是否已是预期项目根。不得仅因邻近存在无关仓库就采用它。

风险根目录:若允许的检查证明当前目录类似家目录、通用目录或与空/当前根前提矛盾,则视为需要专用子目录,其工程产物封闭;第一次项目变更必须先建立该专用子目录,所有脚手架路径与命令工作目录都保持在其下。若技能加载较晚、当前任务产物已存在于被拒绝的根,停止进一步项目变更,仅把这些当前任务产物重定位到专用子目录,不复制、不镜像回被拒绝的根,之后仅在专用子目录继续;修复路径时不检查、移动或删除无关内容。

布局:在该根内使用生态原生布局,入口点、包文件、源码、测试与资产按生态惯例放置;仅当生态惯例或具体近期内容需要时才建目录,不为只含一个文件的装饰性目录而建目录。避免占位文件与推测性分层。未被明确要求独立或单文件的免构建原生 HTML/JavaScript 可玩浏览器应用或游戏,入口 HTML 放在专用项目根,实质行为放入至少一个单独编写的 .js 或 .mjs 源文件;框架或类型化技术栈使用其常规源码模块,不强制根 HTML 或象征性 JavaScript 文件。请求明确选择独立、单文件、可粘贴或离线产物形态时予以保留,产物与验证机制交由 bundled:browser-app-delivery。搭建请求所需的最小完整可运行形态,再使用适用的交付或验证工作流,并清晰报告所选根。交接前审计已知路径及本任务创建或更改的路径,脚手架产物只保留在一个选定项目根下,只重定位或删除其外的当前任务产物,不检查、移动或删除无关内容。

限制:不为已有仓库、项目、笔记本、缺陷修复、仓库维护、仅组件编辑调用本工作流;保留显式独立、单文件、片段或可粘贴交付请求,不将其变成项目。