Communitygithub.com

dubbl-a/house-rules

将 house-rules 适配到较新的 Claude Code 版本或 Claude 模型,确保该包补充而非重复或冲突工具链。

house-rules 是什么?

该技能用于将 house-rules 包自动适配到最新的 Claude Code 版本或 Claude 模型更新。它通过系统性地调查自上次调查以来工具链(harness)的变化,对每个受影响的规则和机制进行分类,并严格检查是否存在重复或冲突。技能会应用必要的改写,记录带有日期的调查部分,并最终发布一个版本。它支持 Claude Code 和 Claude 模型变更,通过分析变更日志、模型文档和提示审计报告来工作。此技能特别适合在用户声明“适配最新的 Claude 更新”、“新 Claude Code 版本发布”、“新模型上线”、“重新调查工具链”或“house-rules 是否仍与当前 Claude Code 兼容”时使用。其核心目标是补充和增强工具链,永远不会与其重复或冲突,除非有明确声明并提到原生功能层。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dubbl-a/house-rules/tree/HEAD/.claude/skills/adapting-to-harness-updates

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

适配工具链更新

包的长期检验标准:补充并改进工具链,绝不重复或与其冲突,除非有意声明且指明了原生功能层。工具链版本更新可能以三种方式打破这一检验标准:原生实现了某个规则或机制的功能,使该规则成为重复;改变了某个规则描述的行为,使该规则变成冲突;或新增了某个规则应引用的功能层。新模型还可能使规则的提示风格显得过时,即使其中的每个事实仍然成立。本技能会识别并修复所有这四种情况。

默认流程

  1. 首先在 origin/main 之外创建一个工作树。 调查工作流需要一个干净的签出版本,因此请将它们指向无人编辑的第二个工作树。
  2. 找到基准。 上次调查的版本和日期位于 docs/handbook/sources/harness-survey.md 的最后一个带日期部分。最新的再调查部分会指定研究库目录。记录在案的模型事实位于 docs/handbook/claude-code.md 的“阶梯”段落中。npm run check:harness 会打印该基准以及自那以来的每个变更日志版本,而计划任务 harness-watch Action 在列表不为空时会提交一个 harness-update issue。当设置了 HARNESS_ROUTINE_URL 和 HARNESS_ROUTINE_TOKEN 密钥时,Action 还会触发一个云例程。该例程会执行增量附录路径,并在 claude/harness-addendum-<version> 上打开一个草稿 PR。如果该 PR 存在,则从此处开始,而不是重新分类。同时与 claude --version 进行比较。
  3. 在新的 CLI 下运行关卡 后再阅读任何内容:在干净的签出上运行 npm run verify。插件验证器以 --strict 模式运行,因此版本更新添加的警告会导致关卡失败,而变更日志分类可以将该条目视为噪声。
  4. 将差异收集到暂存区,每个来源使用一个 agent:
    • Claude Code 变更日志中自基准以来的部分(https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md),这是唯一一个包含变更日期的来源;
    • 模型概览和模型配置页面,用于获取新模型、默认值、价格和努力程度;
    • 工具链自身在该仓库上的提示审计(在会话中运行 /doctor prompt-audit)。它会报告过时的路径、失效的命令、矛盾的指令以及为旧模型编写的提示模式。
  5. 选择深度。 使用下面的判断标准。说明你选择了哪个以及为什么。
  6. 分类和归类。 每个候选项获得一个处置:DUPLICATE(重复)、CONFLICT(冲突)、COMPLEMENT(补充)或 UNIQUE(唯一)(定义见 references/dispositions.md)。在规则文件、plugins/house/orchestration/ORCHESTRATION.md、agent、钩子、技能和评估中搜索任何声称旧行为的文本。
  7. 验证。 只有两个怀疑者都未能反驳时,DUPLICATE 或 CONFLICT 才算成立。一个检查文档准确性,一个检查强制执行实际情况,每个在不确定时默认为已反驳。然后会话读取所引用的行和规则文本本身。任何可以通过运行来解决的问题(--help、使用真实负载的钩子、检查器),都要运行。
  8. 根据处置行动。 解决规则或钩子中的冲突。淘汰重复项,或将其保留为声明重复并指定原生功能层的条目。仅当规则声称或暗示某个功能层时,才改述补充项,并引用事实。记录唯一项并保留原样。提示审计发现只会改变措辞,不会改变规则的声明,并且必须符合检查器强制执行的规则形式。在接受 agent 的偏差、审查者的“非阻塞”注释或“已知限制”之前,指明管理它的 house 规则或文档建议,除非你能说明为什么不能,否则采取推荐的选项。
  9. 记录 到 references/recording-and-release.md 中描述的三个位置。然后按那里的发布流程发布。

选择深度

增量附录(默认)。只分类自基准以来的变更日志部分和模型变更,每个来源一个研究者。将命中项对照规则表面进行分类,然后编写一个带日期的 ## Addendum 章节。这适用于包含修复和小功能的一两个版本更新,以及影响层级和努力程度的模型变更。

全面重新调查。 从文档中重新研究所有工具链领域,对每个规则标题和机制进行分类、验证、综合,并运行完整性评判。然后对评判指出的内容执行差距检查。同时运行增量路径中的变更日志分类:文档页面不包含日期,因此没有变更日志,全面运行无法区分当前页面和过时页面。表明附录不够的信号:

  • 差异同时触及多个领域;
  • 新模型系列或默认值出现;
  • 提示审计标记跨多个文件的模式;
  • 附录在某个领域发现了冲突,而该领域的已有事实早于变更;
  • 上次重新调查的评判列出了自从无人研究过的领域。

脚本是 scripts/house-vs-harness-audit.js(主脚本)和 scripts/house-vs-harness-gap-audit.js(差距脚本)。每个脚本接受 args.repo(指向干净工作树的绝对路径)和 args.date。差距运行还接受来自评判结果的 args.areas 和 args.targets,以及一个可选的 args.context 句子,说明主运行结果及其附录。它们通过 Workflow 工具运行,需要用户明确选择加入。在询问之前,说明 agent 数量:主运行为每个领域分配一个研究者,每个模块分配一个 Opus 分类器,再加上一个用于机制的分类器,每个重复或冲突声明分配两个怀疑者,以及两个综合 agent。

风险

  • 大多数发现是归因问题,而非实质问题。 迄今为止最大的重新调查没有发现重复项和冲突,但发现了 27 处改述,其中规则声称了文档未说明的原生功能层。在任何规则声称工具链执行了某项操作之前,该事实必须存在于资料库或已获取的页面上。
  • 怀疑者只关注重复项和冲突。 补充项的拟议改述会在未经验证的情况下进入报告,并且它可能像旧文本一样容易夸大工具链。在改述发布之前,发送一个反驳者来检查每个改述是否与已有事实一致。
  • 天真的标题计数会漏掉规则。 每个规则文件都以 ## Don't 结尾,而一些真正的规则以“Don't”开头。通过精确匹配而不是前缀来计算标题。
  • 文档页面不包含日期。 在每个引用旁记录获取日期。如果变更日志和页面不一致,信任变更日志的日期和页面的内容。
  • 模型设置存在于仓库之外。 子 agent 功能层和每个模型特有的努力程度是用户设置。当模型变更移动它们时,告诉用户要设置什么;切勿从这里编辑他们的设置。新发布的模型以其自己的默认努力程度运行,直到应用每个模型特有的层级。
  • 提示审计发现可能与 house 规则形状冲突。 对禁止列表或硬数字的审计标记是风格信号。## Don't 章节和长度上限是经过检查的形状和棘轮,因此更改它们是 ADR 下的包决策,而非改述。
  • 分支保护读取命令文本。 使用 Write 工具编写接近分支名称处包含 git 动词的 PR 正文和提交消息,然后通过 --body-file 或 -F 传递它们。
  • 子 agent 不提交。 会话提交并推送 agent 准备好的任何内容。

当此处编辑生效时

此技能是仓库本地的。编辑会在按名称调用它的下一个会话中生效,并且不会向采用者发布。到达采用者的是它产生的规则和机制变更,通过发布和每个采用者的 render --apply 实现。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

相关技能