SuperAPI AI 工具集

ff15-workspace-project-setup

通用与其它

查看项目

更新于 10-15 19:58

技能介绍

用途:为 VS Code 扩展注册或修改工作区本地的 FF15 项目配置。每个项目配置位于 .ff15/projects/<id>.yaml,并通过 .ff15/config/config.yaml 激活。加载器只读取 <id>.yaml 文件,以 _ 开头的文件(如 _template.yaml)是模板,会被忽略。

主要能力:定义项目配置字段,包括 id(必填,须与文件名主干一致)、openspec_root(必填,相对工作区根目录的 OpenSpec 目录路径,须存在)、repos(必填且非空,含 id 与 root,root 相对工作区根目录且须存在)、default_checks(推荐)、summary(可选)。在 config.yaml 中通过 active_projects 列出要激活的项目 id,openspec.project_id 可选指定由哪个活动项目提供 OpenSpec 解析,language 为 en 或 ja。

使用方式:确认工作区根目录与目标配置路径,从 _template.yaml 开始填写,路径均相对工作区根目录并确认存在,将 id 加入 active_projects,必要时设置 openspec.project_id。每次创建或修改后运行校验器:node .claude/skills/ff15-workspace-project-setup/scripts/validate-project-yaml.mjs .ff15/projects/<id>.yaml,可传多个文件、整个目录或 .ff15(同时检查 config.yaml 一致性),Windows 与 WSL 通用,校验失败视为阻塞。

适用场景:新增或编辑项目配置、激活项目、诊断项目未被 OpenSpec 解析、编辑后校验 YAML。

限制:文件名主干必须等于 id;openspec_root 与 repo root 相对工作区根目录而非 .ff15;顶层字段仅限 id、openspec_root、repos、summary;不得跳过校验器。其余细节暂未提供。