配置参考

项目配置位于 .rsp/config.yaml。rsp init 会生成完整的默认配置；rsp update 只回填缺失的默认字段，不覆盖已有自定义值。配置永远不会扩展权限。

Change 类型

空列表使用内置 Change 类型：feature、fix、refactor、docs、ops 与 research。非空配置列表会替换而不是扩展默认值，每个条目必须是唯一的非空字符串。

kinds:
  - feature
  - fix
  - docs

默认配置会写成 kinds: []。

持久化语言

language:
  default: en
  artifacts: zh-CN
  commit: en

language.default 为持久化产物与提交说明提供默认值；可选的 artifacts 和 commit 覆盖相应内容。值使用规范化的 BCP 47 语言标签。

回复语言仍由用户和会话决定，不能通过 language.response 配置。已有产物保持既有语言，除非明确授权翻译。规范标题、命令、路径、标识符、Conventional Commit 类型与作用域、尾注、机器值和 WorkRefs 不本地化。

RSP 不提供 WorkRef 语言或风格配置字段。language.default: zh-CN 可以选择中文 Change 正文，但不会选择中文 WorkRef。当用户没有显式提供标识，最近的项目或领域也没有命名约定时，推断出的 WorkRef 默认使用 ASCII 小写 kebab-case。显式提供或项目约定选择的有效 Unicode WorkRef 仍然受支持并保持不变。

读取有效配置

使用 rsp config 查看简洁的有效项目配置，使用 rsp config --json 获取自动化读取的有效配置摘要；需要单行结果时可追加 --compact。命令形式仍只有 config 和 config --json 两个入口，--compact 只是后者的输出格式选项。该命令只读取并校验 .rsp/config.yaml，不会扫描 Changes、focus、依赖图、归档或 Git 状态。

JSON 返回 Change 类型、Decision Records 路径、Manage 策略和持久化语言的单层有效摘要。例如仅配置 language.default: zh-CN 时，输出中的 language.artifacts 和 language.commit 都是 zh-CN。

Decision Records

Decision Records 默认位于 .rsp/specs/decisions/。如果宿主项目已在其他位置拥有 ADR，只配置一个项目相对的权威目录：

decisions:
  path: docs/adr

该路径不能是绝对路径、不能逃逸宿主项目，也不能指向其他 .rsp/ 核心位置。切换路径不会迁移已有记录。在项目迁移或明确删除旧记录前，rsp doctor 会报告遗留在默认目录的非活动记录。

Manage 策略

manage:
  activation: auto
  closeout: local

activation 接受 explicit 或 auto。Core 会先解析一个 shape-ready owner，并独占首次 Manage 资格判断及 selected | declined 路由结果。自动选择必须存在可观察的协调义务，例如独立切片、恢复、不同的执行与验收 owner、真实宿主验证、有界 Review 收敛、受管 lifecycle 或 ready successor；多个文件或文档表面本身不构成资格。缺少或未就绪的归属先进入 Shape。已选择的 Manage 校验 handoff，但不重复判断 direct 还是 managed。激活不会授予规划、产品修改、生命周期或外部操作权限。

closeout 接受：

• manual：不自动归档或提交。
• lifecycle：成功完成持久化审查后可以归档；提交仍然独立。
• local：自动归档符合条件、已验证、非小型且归属边界干净、路径精确、无混杂或越界改动的受管终态边界，并把这些精确路径一次性路由到本地 Commit，无需用户再次请求。

省略 manage 时，兼容默认值解析为 activation: explicit 与 closeout: local。最近的项目限制与宿主强制规则只能缩小这些上限。RSP 有意不提供 full 预设；推送、标签、发布、部署、批准与人工验收保持显式。

选择行为见 Skills 与受管工作。