Communitygithub.com

dubbl-a/house-rules

查找某个主题由哪条“House 规则”覆盖。读取 `.house/INDEX.md`,从不读取规则正文;用于“某主题的 House 规则是什么”以及“House 对某主题是否有约定”。

house-rules 是什么?

此技能能够高效地回答一个关键问题:团队(House)对某个主题有什么规定,以及该规定在哪里。它通过读取渲染阶段生成的索引文件(`.house/INDEX.md`)来实现,而无需遍历仓库中所有规则文件。索引文件包含了每条规则的文件路径、标题以及一句话摘要,对于大多数查询,这些信息就足够回答问题了。该技能支持多种“逃生舱”场景,例如仓库未采用 House 规则、索引中无匹配项、索引内容过时,以及用户需要查看完整规则文本的特殊情况。它适用于任何采用 House 规则管理系统的仓库。通过严格限定自身行为——不加载全部规则文件、不依赖会话记忆、不修改托管文件、不捏造规则——确保了查询结果的准确性和可靠性。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dubbl-a/house-rules/tree/HEAD/plugins/house/skills/conventions

在你喜欢的 AI 中提问

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

文档

团队约定查找

本技能回答一个问题:团队对某个主题怎么说,以及该规定在哪里。它读取渲染步骤生成的索引文件,绝不读取规则文件本身。这正是索引存在的意义:一次查找只需消耗一个小文件,而非仓库中的每个规则文件。

默认流程

  1. 读取仓库根目录下的 .house/INDEX.md。回答问题时不要打开 .claude/rules/**、docs/handbook/** 或 plugins/house/modules/**/rules/** 下的任何文件。索引包含了每个引入规则的文件、标题和一句话摘要,这本身足以回答大部分查询。
  2. 在索引中搜索其文件名、标题或一句话摘要与问题匹配的条目。基于语义和关键词进行匹配,而非精确措辞。关于提交消息的问题应匹配关于提交的标题,即使措辞不同。
  3. 列出所有匹配项,而不是只列第一个。一个主题可以合法地存在于多个规则文件中(文档规则和工程规则可能都涉及同一问题),遗漏真实匹配会导致答案因遗漏而错误。
  4. 对于每个匹配项,如实报告规则文件路径、标题和索引中的一句话摘要。指向引用(file#slug),以便用户自行打开真实规则查看完整文本。
  5. 就此打住。不要概括、扩展或根据记忆或会话中先前读过的内容重构规则正文。索引中的一句话摘要就是此技能给出的答案;链接的规则文件才是完整规则所在。

逃生舱

  • 仓库中没有 .house/INDEX.md 文件。 直白地说明该仓库尚未采用 House 规则,或者它运行在索引存在之前的旧版本上。不要根据训练知识、CLAUDE.md 概览或其他仓库的规则来猜测答案。就此打住。
  • 索引中没有与问题匹配的项。 直白地说明 House 规则中对此主题没有规定。不要发明一条,也不要牵强地将一个松散相关的条目套用到它无法回答的问题上。
  • 索引看起来过时了。 列出的标题不再出现在其规则文件中,或者列出的规则文件完全丢失。说明索引看起来过时了,指出过时的内容,并建议运行 /house-rules:sync。仍然报告索引给出的最佳匹配项;过时的索引只是答案的一个附带说明,而不是隐瞒答案的理由。
  • 用户想要完整的规则文本,而不仅仅是位置。 只有在这种情况下,才读取索引指向的那一个规则文件。绝不为此打开整个规则集。在索引匹配已经找到之后再读取单个文件,而不是之前。

禁止事项

  • 不要加载所有规则文件来回答查询。这正是索引存在所要避免的成本。
  • 不要根据同一会话中之前读过的规则文件来回答。每次都要重新检查索引;一次同步可能会在会话中途改变索引内容。
  • 不要从本技能中编辑 .house/INDEX.md、.claude/rules/house/** 或任何其他托管文件。对托管文件的本地编辑属于 /house-rules:sync 拒绝流程,而非查找流程。
  • 当索引中与所提问题没有匹配项时,不要捏造一条 House 规则。
  • 不要将此技能变成一个菜单。回答所提出的问题;只有当问题本身足够宽泛以至于跨越多个模块时,才列出所有候选模块。

Individual skills in this repo

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

相关技能