SuperAPI AI 工具集

project-config

通用与其它

查看项目

更新于 11-06 09:09

技能介绍

project-config 是一个面向 easy-claude 的实用技能,用途是把项目配置文件(默认 docs/project-config.json)与当前工作区结构保持同步,使配置文件始终有效且准确,同时只补充有证据支持的可选项目细节。

主要能力:

  • 配置文件为其必需产物,最小有效内容为 {"project":{"name":"<derived name>"}};其余属性均为可选。
  • 在配置缺失或无效时,通过 project-config 或 project-init 修复;缺失每日提示一次,无效会附加“事实未经核实”警告,均不阻塞提示。
  • 通过 schema 描述命令获取准确字段名,按字段逐项推导,避免使用错误字段名(如应使用 contentPattern/keyGroup,而非 classPattern/keyExtractor)。
  • 工作流为 Recon → Plan → Execute → Validate;每个选定配置区域单独跟踪,合并后立即做 schema 校验,并逐阶段回读、抽查路径、自查修复。
  • 支持帮助模式(--help):只读、不扫描、不改文件,直接展示生成器输出并停止。
  • 保护 schema:禁止重命名、删除或重构顶层区段,禁止更改字段类型;新项目不填充已弃用的 v1 区段,已有 v1 数据保留。
  • 涵盖模块(后端/前端)、项目元数据、hooks.startupInstall 启动安装、specRoots/specArtifacts/docsRoots/techSpecScan 等可选区段的按证据推导规则;缺少可选区段表示采用默认值或有证据的跳过,不得创建空区段。

使用方式(基于资料中的命令与流程):运行 node .claude/hooks/lib/project-config-schema.cjs --describe 读取 schema;用加载器解析并检查配置文件路径是否存在,用校验函数验证现有配置;按选定阶段执行扫描、合并、验证、修复;中大型项目可创建 tmp/project-config 存放临时阶段报告,合并后删除。用户若询问“可配置什么”,进入帮助模式并停止,不启动扫描。

适用场景:维护 easy-claude 项目配置、补充有仓库证据支撑的模块与文档路径配置、修复缺失或无效配置、处理本地工作流路由覆盖设置(.claude/.ck.local.json)等。

限制:不得从项目名推断语言、架构、框架、测试或产品能力;不得编造架构或测试用例;可选区段若声明但不完整或不受支持,必须显式修复或移除,不能当作不存在;字段名、正则跨平台分隔符([\/])等有严格规则;帮助模式仅只读。具体平台支持、收费与版本信息暂未提供。