SuperAPI AI 工具集

openspec-config

通用与其它

查看项目

更新于 10-16 03:15

技能介绍

用途:管理 OpenSpec 两个层级的配置——项目配置(openspec/config.yaml)用于项目专属上下文与规则,全局 CLI 配置(openspec config 子命令)用于用户级设置。适用于需要为项目补充上下文、按产物设置规则(如 specs 必须使用 Given/When/Then)、修改项目默认 schema、管理全局 CLI 设置(遥测、编辑器等)的场景。

前置条件:项目已初始化 OpenSpec。

项目配置:openspec/config.yaml 支持 schema(新变更默认 schema,如 spec-driven)、context(注入所有产物指令的项目上下文,上限 50KB)、rules(按产物 ID 键控的规则对象)。schema 优先级由高到低为:CLI 标志 -> 变更元数据 -> 项目配置 -> 默认(spec-driven)。context 会以 project-context 标签前置到每个产物指令中;rules 仅对匹配产物生效。spec-driven schema 的产物 ID 包括 proposal、specs、design、tasks。

全局 CLI 配置命令:openspec config list、openspec config get <key>、openspec config set <key> <value>、openspec config unset <key>、openspec config reset --all --yes、openspec config edit、openspec config path。常见设置如关闭遥测:openspec config set telemetry.enabled false;设置用户名:openspec config set user.name "My Name" --string。

输出:openspec/config.yaml 及通过上下文注入改善的 AI 产物质量。后续可使用 openspec-new 或 openspec-explore,或用 openspec-schema 创建自定义 schema 并在配置中设为默认。

限制与排错:rules 中未知产物 ID 需与 schema 匹配,可运行 openspec schemas --json 核对;配置不生效需确认文件名为 openspec/config.yaml(非 .yml)且 YAML 语法正确;context 超过 50KB 需精简或链接外部文档。其他平台与价格信息暂未提供。