SuperAPI AI 工具集

activation

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:该技能用于在已提供 Forge(全局插件或 npm dev-dep 安装)但尚未介入的项目中做初始引导。它本身不创建任何内容,仅负责先观察、后提供选项,绝不强制执行。

主要能力:先运行只读检查并在提供任何设置前用一小段话陈述发现。检查内容包括:是否已初始化 Forge(test -d .forge && echo present || echo absent);项目类型(有 package.json 为 JS/TS 项目,需注意锁文件对应的包管理器 bun/npm/pnpm/yarn;大量 Markdown 且无 package.json 为文档/规划仓库;否则描述所见语言与构建文件);是否为 git 仓库(git rev-parse --is-inside-work-tree 2>/dev/null)。陈述完成后再以对话式选择提供最小建议。

使用方式:若 .forge/ 不存在,说明 Forge 无需设置即可受益——只读命令(forge status、forge ready、forge show <id>)立即可用且不写入任何内容;首个变更类命令(forge claim、forge create、forge remember)会惰性创建最小化、关闭 gates 的 .forge/ 骨架。除非用户随后运行 forge setup,否则不会安装更重的内容(git hooks、lefthook、受保护路径、.mcp.json、scripts 树)。若 .forge/ 已存在,则说明情况并路由到相应阶段,本技能工作即完成。提供选项后应停止并让用户选择,未经要求不代跑 forge setup 或安装 hooks。

适用场景与后续:属于入门原语而非完整工作流。引导并提供选项后,新/未界定工作(如“做 X”)下一步指向 /plan;已知待实现任务指向 /dev;询问“我在哪/什么就绪”指向 /status 或 forge ready;缺陷或失败先用 systematic-debugging 再进入匹配阶段。需明确指定唯一的下一步并交接,本技能不在此实现。

限制:技能自身不改动项目;初始化由首个变更类命令惰性触发;更重的设置需用户主动运行 forge setup。