rules-repo-conventions
应用规则库约定和仅前向工作流。在使用此库的项目中生成或编辑文档、提示或代码,或当此库是活动工作空间时使用。确保创建和更新Pact → Rules → Guides → Implementation链接,并优先链接到子模块指南而不是复制内容。
📖 中文导读:应用规则库约定和仅前向工作流。在使用此库的项目中生成或编辑文档、提示或代码,或当此库是活动工作空间时使用。确保创建和更新Pact → Rules → Guides → Implementation链接,并优先链接到子模块指南而不是复制内容。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: rules-repo-conventions description: Apply Rules Repository conventions and forward-only workflow. Use when generating or editing docs, prompts, or code in projects that consume this repository or when this repository is the active workspace. Ensure Pact → Rules → Guides → Implementation links are created and updated, and prefer linking to submodule guides over duplicating content.
Rules Repository Conventions
This Skill encodes the essential conventions for working with this repository (as a submodule or directly) so Claude can apply them automatically.
Instructions
- Load and apply the repository root skills catalog: see skills.md.
- Honor RULES.md anchors for behavior and technical commitments:
- Close loops between artifacts:
- Pact → Rules → Guides → Implementation, and back-links from Implementation to its source guide and rule.
- Link discipline:
- Use relative paths; do not place project-specific docs inside the Rules Repository submodule directory when used downstream.
- Observability defaults:
- Prefer wiring to the Observability index and relevant guides: generative/platform/observability/README.md.
- When adding new topic docs under generative/:
- Add the entry to the nearest topic index README and cross-link to related guides.
- When updating structure/content:
- Apply the Forward-Only policy in one change: update or remove conflicting docs and links; no compatibility stubs.
Examples
- When scaffolding a new host project README, include links to PACT.md, RULES.md, GUIDES.md, IMPLEMENTATION.md, and the Rules Repository submodule path.
- When creating a new Observability guide, add it to generative/platform/observability/README.md and cross-link from related platform indexes.
Validation Checklist
- Links resolve and remain relative
- Loop closure present (forward/back links)
- No project-specific files placed inside the submodule directory
- Forward-only edits applied (no legacy anchors retained)
See also
- Repository skills catalog — skills.md
- Enterprise RULES — RULES.md
- Platform Observability — generative/platform/observability/README.md