Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

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.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. 核心理念:规则是智识与经验的“轻量缓存”
  2. 核心工作铁律:严禁重新采访用户(No Re-interviewing)
  3. 物理存储规范:.agents/rules/<rule-name>.md
  4. 编写黄金法则:如何让 AI 3秒内吸收规则?
  5. 标准规则模板参考
  6. 标准执行流程
Sekcje z nagłówków SKILL.md, w oryginale · 97 linii, 195 słów
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

RepozytoriumWynikLicencja
Ta strona · ShenQingchuan/skills100MIT
coco-research/coco100MIT
kensaurus/cursor-kenji100MIT
paultyng/skill-issue100MIT
seqra/opentaint96Apache-2.0
NeoLabHQ/context-engineering-kit95GPL-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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.