create-rule
/create-rule
Tworzy lub utrwala pliki reguł projektu: zapisuje standardy kodowania, utrwala ustalenia z przeglądu kodu i dodaje nowe reguły w katalogu zasad.
- Autor
- ShenQingchuan ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Tworzy lub utrwala pliki reguł projektu: zapisuje standardy kodowania, utrwala ustalenia z przeglądu kodu i dodaje nowe reguły w katalogu zasad.
Oryginalny opis (EN)
为项目创建或沉淀规则约束文件(Rule)。当用户要求记录编码规范、固化团队开发约束、沉淀 Code Review 经验或在 .agents/rules/ 下新建规则时使用。
Jak działa
- 核心理念:规则是智识与经验的“轻量缓存”
- 核心工作铁律:严禁重新采访用户(No Re-interviewing)
- 物理存储规范:.agents/rules/<rule-name>.md
- 编写黄金法则:如何让 AI 3秒内吸收规则?
- 标准规则模板参考
- 标准执行流程
Podgląd SKILL.md
---
name: create-rule
description: 为项目创建或沉淀规则约束文件(Rule)。当用户要求记录编码规范、固化团队开发约束、沉淀 Code Review 经验或在 .agents/rules/ 下新建规则时使用。
---
# Create Rule
本技能用于为项目沉淀开发规范与约束规则,存放在项目根目录的 **`.agents/rules/`** 目录下。
---
## 核心理念:规则是智识与经验的“轻量缓存”
- **本质**:把团队踩过的坑、达成的开发默契以及代码审查(Code Review)中沉淀的经验,以**高信息密度、易于吸收的形式缓存起来**。
- **渐进式吸收**:规则不需要靠复杂的程序去强行监控或自动拦截,而是作为项目知识库的一个个“锦囊”。当 Agent 准备修改某块逻辑或编写特定代码时,能直接去翻对应的规则快速吸收,避免重蹈覆辙。
- **纯粹通用**:不依赖特定 IDE 或工具专有的拦截机制,使用纯粹、标准的 Markdown 文件,对任何 Agent 都开箱即用。
---
## 核心工作铁律:严禁重新采访用户(No Re-interviewing)
- **默认行为**:用户通常是在刚刚讨论完某段代码的设计、纠正了一个 Bug、或者明确指出了代码偏好后调用本技能。
- **直接提炼**:直接从当前会话的讨论记录、代码比对中抽取规则核心,组织成精炼文档并直接落盘。
- **拒绝八股文提问**:绝不要像面试官一样反问“请问这条规则的背景是什么、希望应用在什么场景”。直接给出最佳初稿,由用户审阅确认。
---
## 物理存储规范:`.agents/rules/<rule-name>.md`
每个规则都是 `.agents/rules/` 目录下的一个独立 Markdown 文件,建议采用小写英文字母与连字符命名:
```text
.agents/rules/
├── error-handling.md # 错误处理与日志捕获约定
├── api-conventions.md # 接口命名与字段风格规范
├── state-management.md # 状态管理与数据流约定
└── database-queries.md # 数据库查询防坑指南
```
- **单一职责(One Concern Per Rule)**:一个规则文件只说透一个具体的话题,绝不把所有规矩杂糅成无法阅读的长篇大论。
---
## 编写黄金法则:如何让 AI 3秒内吸收规则?
### 1. 篇幅精炼,去粗取精
控制在 **30~80 行内**。不要写长篇大论的宏观说教,开门见山,直接给出硬核要求。
### 2. 代码对比胜过千言万语(❌ BAD vs ✅ GOOD)
对 Agent 而言,最强有力的约束不是形容词,而是具象的代码对比:
- 给出反面典型(❌ BAD),说明“别这么干”;
- 给出标准示范(✅ GOOD),说明“应该怎么写”。
### 3. 一句话说清“为什么”(The Why)
简明交代这条规则背后的痛点(如:“防止并发下数据不一致”、“避免无意义的吞异常导致排查困难”),让 Agent 真正理解逻辑,遇到变形场景时也能正确推导。
---
## 标准规则模板参考
```markdown
# [规则名称,如:错误处理与上报约定]
## 核心原则
所有业务操作的报错必须包含上下文信息,禁止静默吞掉异常,方便快速定位生产问题。
## 规范对比
### 1. 捕获与抛出
\`\`\`typescript
// ❌ BAD:捕获后什么都不做,或者只打个空日志丢弃原始堆栈
try {
await fetchUserData(userId);
} catch (e) {
console.log("error");
}
// ✅ GOOD:附带业务上下文并保留原始 cause 抛出,或者调用统一日志记录器
try {
await fetchUserData(userId);
} catch (error) {
logger.error("Failed to fetch user data for checkout", { userId, error });
throw new UserDataFetchError("Unable to load user profile", { cause: error });
}
\`\`\`
## 关键要点
1. 错误日志必须携带关键入参(如 ID、流水号)。
2. 面向前端展示的文案与内部日志信息严格分离,内部日志保留完整堆栈。
```
---
## 标准执行流程
1. **提取讨论成果**:从上下文(如 Code Review 过程、Bug 修复讨论、用户口述偏好)中提取规范核心。
2. **提炼规则主题**:确定简短、精准的文件名(如 `.agents/rules/<rule-name>.md`)。
3. **编写与落盘**:组织原则、❌ BAD / ✅ GOOD 对比代码与核心要点,直接写入文件。
4. **交付成果**:通知用户文件生成路径与核心规则概要,请用户审阅。
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · ShenQingchuan/skills | 100 | MIT |
| coco-research/coco | 100 | MIT |
| kensaurus/cursor-kenji | 100 | MIT |
| paultyng/skill-issue | 100 | MIT |
| seqra/opentaint | 96 | Apache-2.0 |
| NeoLabHQ/context-engineering-kit | 95 | GPL-3.0 |
Migawka bazy z 13.11.2026 · wersja paczki 5ce641698ee2 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90repo-propagating-rules
Przeprowadza propagację reguł repozytorium przy dodaniu, zmianie lub usunięciu, aktualizując pliki zasad, agentów i CI. - 100coding-standards
Pisze, aktualizuje i sprawdza plik CODING_STANDARDS.md i zamienia błędy z sesji lub przeglądu w reguły kodowania. - 100rule-file-writing
Pisze i optymalizuje pliki reguł ładowane przez asystenta kodowania dla użytkownika, projektu lub katalogu, usuwając zbędny balast. - 100code-review
Prowadzi uporządkowany protokół przeglądu kodu względem pełnego zestawu reguł, przydatny przy audycie kodu własnego lub napisanego przez innego agenta. - 100run-patdown
Uruchamia narzędzie patdown na plikach lub katalogu według reguł z AGENTS.PATDOWN.md i sprawdza zapisy względem reguł. - 10005-rule-generate
Tworzy, aktualizuje, publikuje lub usuwa regułę kodowania w narzędziach AI hosta, czyli konwencję lub standard kodowania.