RSP — Reliable Software Practice

English | 简体中文

面向人类与 AI 智能体的仓库原生工程工作流。

RSP 把模糊意图转化为经过塑造、实现、审查和验证的软件变更，同时让项目知识可持久化、工作可恢复。它使用普通仓库文件——规则、规格和计划——而不是隐藏的工作流状态。

RSP 帮助你完成什么

• 把模糊工作塑造成一个可执行 Change。
• 在实现前根据仓库证据解决设计问题。
• 把诊断、实现、TDD、审查和发布工作路由给明确的能力。
• 把当前事实、长期理由、作用域指令和完成历史保存在正确的归属位置。
• 保持权限可见：RSP 不会推断提交、发布、部署或批准权限。

意图 → 塑造 → 必要时设计 → 诊断 | TDD | 实现
     → 审查 → 持久化审查 → 归档

五分钟入门

RSP 需要 Node.js 22（>=22）。使用当前稳定版本：

npx -y @oevery/rsp@latest init --with-project-setup
# 填写 .rsp/changes/project-setup.md
# 填写 .rsp/specs/design.md
npx -y @oevery/rsp@latest doctor
npx -y @oevery/rsp@latest status --json

然后创建并聚焦一个受跟踪变更：

rsp create improve-login "让登录失败信息可供用户采取行动"
rsp focus improve-login
rsp show --focused

遵循最近的 AGENTS.md，在工作推进时同步当前聚焦的 Change，运行最新的项目检查，判断是否需要持久化更新，并仅在满足验收条件后归档。

阅读完整入门指南。

产物模型

.rsp/
├── rsp-rules.md       # 最小后备协议
├── specs/             # 持久化的当前事实
├── changes/           # 未完成工作
├── focus.d/           # 选择当前工作的空标记文件
└── archives/          # 已完成历史

一个 Change 是包含规范的 Proposal、Spec、Design、Tasks、Verify 和 Blockers 章节的单个 Markdown 文件。稳定事实属于 Specs，长期理由属于 Decision Records，稳定且有作用域的操作指令属于最近的项目自有 AGENTS.md。

文档

• 开始使用
• 核心概念与产物归属
• 日常工作流
• Skills 与受管工作
• 配置参考
• CLI 参考
• 3.0 迁移指南与 3.1 迁移指南
• 发布说明
• 设计哲学与维护者上游研究

在本地运行文档：

pnpm docs:dev
pnpm docs:check
pnpm docs:build

网站只是本仓库 Markdown 的展示层。它提供双语导航、本地搜索和页面目录，不引入内容数据库或运行时服务。

平台支持

RSP 是与工具无关的文件约定，适用于任何能读取项目文件的助手或编辑器。人类从这里开始；AI 智能体遵循最近的 AGENTS.md，优先加载 skills/rsp/SKILL.md，仅在 Skill 不可用时使用 .rsp/rsp-rules.md 后备协议。

RSP 使用 MIT 许可证。