ericrisco/rsc-harness

项目定位

编码助手每次开新会话都没有项目记忆，也无法可靠地接触真实工具。rsc-harness 是一个 CLI，用来在已有助手外面搭建并维护一套 harness：项目本地知识库、记录真实工具连接的约定、从 274 个技能中挑选的集合，以及在支持该能力的提供商上生效的规则与钩子。

它面向已经在真实项目中使用 Claude Code、Codex、Gemini CLI、Cursor 或 Copilot 等助手的人。编辑器、模型和现有项目都保持不变，rsc 只提供外围配置。安装是规划式的而不是即兴拼装：每个组件都会标注为选中、暂缓或排除并附原因，你在写入任何文件之前先接受这份计划。

安装与初始化

在你要配置的项目目录中执行，不要在 rsc 仓库的克隆里执行：

npx @ericrisco/rsc@latest onboard

向导会询问对话的技术化程度、项目类型、目标以及要适配的助手，然后打印完整计划。首次执行不写任何文件，只输出一个 SHA-256 计划 id；接受该计划后才真正落盘。

非交互用法是先收集答案，再用打印出的 id 二次执行：

npx @ericrisco/rsc@latest onboard --technical-level technical \
  --project-kind software --goal "small compound-interest website" \
  --software-scope small --target codex

npx @ericrisco/rsc@latest onboard --technical-level technical \
  --project-kind software --goal "small compound-interest website" \
  --software-scope small --target codex --accept-plan <PLAN_ID>

如果预览到接受之间项目证据发生变化，rsc 返回 RSC_PLAN_CHANGED，需要重新审查计划。安装后技能文件写入 .rsc/skills/<id>/，各助手通过符号链接（Windows 上为副本）指向共享目录；rsc doctor 分别报告 harness 健康度和初始化完成状态，rsc repair 修复接错线的安装，rsc reassess 报告新出现依据的暂缓组件但不自动安装。执行 npm install -g @ericrisco/rsc 后可用简短的 rsc 命令。完整命令列表见 使用与 CLI 文档，概览见项目主页。

工作方式

每一轮对话走三条车道之一：只读回答、带单一功能文档与证据追踪的快速改动（FTD），或针对相互耦合决策的十阶段规格驱动链（SDD）。由 agent 选择并说明车道，你也可以要求切换。

项目上下文存放在聊天之外的 02-DOCS/，可直接作为 Obsidian 库打开；工具连接记录在 01-TOOLS/，每个工具一个目录，包含凭据示例和连接测试。技能按需渐进加载，任务用到之前只消耗描述部分的上下文。

使用约束

• 钩子只在 Claude Code 中强制执行。 它在那里负责车道判定、拒绝在已关闭的 main 上提交、在执行破坏性命令前确认。Codex、Gemini、Cursor 和 OpenCode 中同样的规则通过技能和会话记忆传达：会被遵守，但没有机制强制。
• Git 权限因助手而异。 全新 harness 允许 agent 直接执行 git commit、git push 和 gh pr create，force-push 仍需确认；安全的逐命令白名单只在 Claude Code、Codex、Gemini 和 OpenCode 中存在，Cursor 和 DeepSeek Harness 不覆盖。
• 会话记忆仅限本地。 在支持的目标上运行时不做网络请求，也不保存提示词、回复、工具输出、文件内容或密钥；保留 30 天，单次注入最多 4,096 字节。Cursor 桌面端只通过常驻规则提供辅助式记忆。
• 模型和外部服务费用由对应提供商收取；技能评分标准中的检查也不保证业务结果。
• 共享 harness 需要提交受管文件。 克隆者需要 .rsc.json，Claude Code 项目还需提交 .claude/settings.json 和 .claude/rsc-bootstrap.mjs，然后执行 npx @ericrisco/rsc@<catalogVersion> sync 按锁定的目录版本重建。

项目采用 MIT 许可证。

HotRepo 点评

在截至 2026-11-01 的一周里，rsc-harness 以新增 147 Star 进入 HotRepo JavaScript 周榜第 6 名，总 Star 达到 418，Fork 58。周榜衡量的是单周增长，不代表采用率或代码质量；站内没有记录到全语言日榜名次。

这条记录说明的是一个以维护性而非单项能力为卖点的工具获得了较快的前期关注。README 少见地主动写清边界——钩子只在 Claude Code 生效、Cursor 没有逐命令白名单——这让它与更轻量的提示词文件方案形成具体对比：你买到的是可检查、有文档的配置，以及一个目标上的强制护栏和其他目标上的建议性规则。