配置参考
项目配置位于 .rsp/config.yaml。省略可选映射时保留兼容默认值;配置永远不会扩展权限。
Change 类型
内置 Change 类型为 feature、fix、refactor、docs、ops 与 research。非空配置列表会替换而不是扩展默认值,每个条目必须是唯一的非空字符串。
kinds:
- feature
- fix
- docs持久化语言
language:
default: en
artifacts: zh-CN
commit: en存在 language 映射时,default 必填。它为持久化产物与提交说明提供默认值;可选的 artifacts 和 commit 覆盖相应内容。值使用规范化的 BCP 47 语言标签。
回复语言仍由用户和会话决定,不能通过 language.response 配置。已有产物保持既有语言,除非明确授权翻译。规范标题、命令、路径、标识符、Conventional Commit 类型与作用域、尾注、机器值和 WorkRefs 不本地化。
Decision Records
Decision Records 默认位于 .rsp/specs/decisions/。如果宿主项目已在其他位置拥有 ADR,只配置一个项目相对的权威目录:
decisions:
path: docs/adr该路径不能是绝对路径、不能逃逸宿主项目,也不能指向其他 .rsp/ 核心位置。切换路径不会迁移已有记录。在项目迁移或明确删除旧记录前,rsp doctor 会报告遗留在默认目录的非活动记录。
Manage 策略
manage:
activation: auto
closeout: lifecycleactivation 接受 explicit 或 auto。自动激活允许 Core(核心协议)为符合条件的工作选择控制器,但不授予修改或生命周期权限。
closeout 接受:
manual:不自动归档或提交。lifecycle:成功完成持久化审查后可以归档;提交仍然独立。local:在生命周期收尾基础上,允许符合条件、工作树干净、已验证、非小型终态边界执行一次有独立依据的本地提交。
省略 manage 时,兼容默认值解析为 activation: explicit 与 closeout: local。最近的项目限制与宿主强制规则只能缩小这些上限。RSP 有意不提供 full 预设;推送、标签、发布、部署、批准与人工验收保持显式。
选择行为见 Skills 与受管工作。