Skip to content
Apothem
أمثلة

قاعدة مخصّصة

تأليف قاعدة دائمة مخصّصة لمشروعك.

يُضيف هذا المثال قاعدة دائمة التفعيل خاصّة بالمشروع تفرض اصطلاح تسمية على جميع الملفات.

ملف القاعدة

---
name: "kebab-filenames"
description: "Enforce kebab-case filenames in the src/ tree"
pathFilter: ""
alwaysApply: true
---

# Kebab-case filenames

All new files created under `src/` MUST use kebab-case naming
(lowercase letters, digits, and hyphens only — no underscores,
no camelCase, no PascalCase).

**Correct:** `src/styles/button-group.css`, `src/components/nav-bar.css`
**Incorrect:** `src/styles/buttonGroup.css`, `src/components/NavBar.css`

When in doubt, err on the side of more hyphens.

احفظ هذا في rules/kebab-filenames.md داخل جذر تثبيت إطار العمل لديك (~/.claude/ لمحوّل Claude Code؛ وفي الحالات الأخرى استبدل المسار الأصلي لإطار العمل).

التحقّق من أن القاعدة سليمة البنية

شغّل مدقّق frontmatter على ملف القاعدة الذي كتبته للتوّ. استخدم الأمر الأول من نسخة Apothem مسحوبة من المستودع، حيث يجعل PYTHONPATH=src الحزمةَ قابلةً للاستيراد. واستخدم الأمر الثاني بعد التثبيت عبر السكربت، حيث يعيش المصدر تحت $HOME/.apothem/src:

# From an Apothem checkout
PYTHONPATH=src python -m apothem.conformity.gate --check frontmatter-grep ~/.claude/rules/kebab-filenames.md

# After a script install
PYTHONPATH="$HOME/.apothem/src" python -m apothem.conformity.gate --check frontmatter-grep ~/.claude/rules/kebab-filenames.md

تُبلغ القاعدة السليمة البنية عن اجتياز نظيف:

{
  "orchestrator": "conformity-gate",
  "passed": true,
  "grep_count": 1
}

النشر إلى أُطُر العمل

شغّل أمر التحديث مرة واحدة لكل إطار عمل مثبّت:

apothem update --harness claude-code
apothem update --harness cursor --project /path/to/project

On this page