Skip to content

BuilderIO/agent-native / packages/core/docs

agent-native-docs

Unverified

How to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.

FileKindSize
AGENTS.mdmarkdown6.0 KB
SKILL.mdskill md2.2 KB
content/a2a-protocol.mdxmarkdown37.6 KB
content/actions-access-control.mdxmarkdown28.9 KB
content/actions-advanced.mdxmarkdown13.1 KB
content/actions-agent-tools.mdxmarkdown5.6 KB
content/actions-defining.mdxmarkdown31.2 KB
content/actions-other-surfaces.mdxmarkdown10.3 KB
content/actions-overview.mdxmarkdown8.3 KB
content/actions-run-context.mdxmarkdown9.1 KB
content/add-ui-to-your-agent.mdxmarkdown5.0 KB
content/administered-deployments.mdxmarkdown7.7 KB
content/agent-mentions.mdxmarkdown10.2 KB
content/agent-native-config.mdxmarkdown34.9 KB
content/agent-native-toolkit.mdxmarkdown17.3 KB
content/agent-resources.mdxmarkdown27.0 KB
content/agent-surfaces.mdxmarkdown33.8 KB
content/agent-teams.mdxmarkdown13.4 KB
content/agent-web-surfaces.mdxmarkdown10.7 KB
content/agentkit.mdxmarkdown14.0 KB
content/audit-log.mdxmarkdown14.3 KB
content/authentication.mdxmarkdown30.7 KB
content/automation-connectors.mdxmarkdown7.8 KB
content/automations.mdxmarkdown26.7 KB
content/aws-amplify.mdxmarkdown10.7 KB
content/aws-lambda.mdxmarkdown13.9 KB
content/aws-rds.mdxmarkdown1.7 KB
content/azure-postgresql.mdxmarkdown1.8 KB
content/azure-static-web-apps.mdxmarkdown9.1 KB
content/blueprint-installer.mdxmarkdown6.3 KB
content/cli-adapters.mdxmarkdown5.7 KB
content/client-advanced.mdxmarkdown13.1 KB
content/client-agent-chat.mdxmarkdown17.7 KB
content/client-data.mdxmarkdown19.3 KB
content/client-entry-points.mdxmarkdown1.2 KB
content/client-overview.mdxmarkdown10.6 KB
content/client-routing.mdxmarkdown5.7 KB
content/client-sync-internals.mdxmarkdown5.2 KB
content/cloneable-saas.mdxmarkdown16.6 KB
content/cloud-sql.mdxmarkdown2.3 KB
content/cloudflare.mdxmarkdown8.3 KB
content/code-agents-ui.mdxmarkdown26.6 KB
content/components.mdxmarkdown42.9 KB
content/context-awareness.mdxmarkdown24.9 KB
content/create-with-an-agent.mdxmarkdown8.8 KB
content/creating-templates.mdxmarkdown21.6 KB
content/cross-app-connect-design.mdxmarkdown8.4 KB
content/cross-app-sso.mdxmarkdown8.7 KB
content/custom-design-system.mdxmarkdown17.3 KB
content/data-programs.mdxmarkdown25.0 KB
content/decisions.mdxmarkdown7.9 KB
content/deno-deploy.mdxmarkdown7.2 KB
content/deploy-an-app.mdxmarkdown5.0 KB
content/deployment-environment-variables.mdxmarkdown16.3 KB
content/deployment.mdxmarkdown11.3 KB
content/dispatch.mdxmarkdown18.6 KB
content/docker.mdxmarkdown8.1 KB
content/docs-components.mdxmarkdown28.9 KB
content/doctor.mdxmarkdown21.3 KB
content/drafts/clips-experimental-features.mdmarkdown5.4 KB
content/drop-in-agent.mdxmarkdown16.0 KB
content/durable-background-runs.mdxmarkdown13.8 KB
content/durable-resume.mdxmarkdown10.0 KB
content/embedding-sdk.mdxmarkdown31.3 KB
content/environment-variables.mdxmarkdown29.9 KB
content/evals.mdxmarkdown12.4 KB
content/extensions.mdxmarkdown34.8 KB
content/external-agents-catalog.mdxmarkdown40.5 KB
content/external-agents.mdxmarkdown29.3 KB
content/file-uploads.mdxmarkdown10.7 KB
content/generative-ui.mdxmarkdown10.8 KB
content/getting-started-actions.mdxmarkdown2.7 KB
content/getting-started-pages.mdxmarkdown2.6 KB
content/getting-started.mdxmarkdown7.2 KB
content/harness-agents.mdxmarkdown16.9 KB
content/http-api.mdxmarkdown20.9 KB
content/integrations.mdxmarkdown33.8 KB
content/internationalization.mdxmarkdown6.2 KB
content/key-concepts.mdxmarkdown30.6 KB
content/koyeb.mdxmarkdown7.3 KB
content/locales/ar-SA/a2a-protocol.mdxmarkdown48.5 KB
content/locales/ar-SA/actions-access-control.mdxmarkdown40.8 KB
content/locales/ar-SA/actions-advanced.mdxmarkdown16.3 KB
content/locales/ar-SA/actions-agent-tools.mdxmarkdown8.1 KB
content/locales/ar-SA/actions-defining.mdxmarkdown42.2 KB
content/locales/ar-SA/actions-other-surfaces.mdxmarkdown14.5 KB
content/locales/ar-SA/actions-overview.mdxmarkdown11.3 KB
content/locales/ar-SA/actions-run-context.mdxmarkdown11.1 KB
content/locales/ar-SA/add-ui-to-your-agent.mdxmarkdown3.7 KB
content/locales/ar-SA/administered-deployments.mdxmarkdown6.4 KB
content/locales/ar-SA/agent-mentions.mdxmarkdown11.8 KB
content/locales/ar-SA/agent-native-toolkit.mdxmarkdown17.3 KB
content/locales/ar-SA/agent-resources.mdxmarkdown36.8 KB
content/locales/ar-SA/agent-surfaces.mdxmarkdown48.4 KB
content/locales/ar-SA/agent-teams.mdxmarkdown18.5 KB
content/locales/ar-SA/agent-web-surfaces.mdxmarkdown14.3 KB
content/locales/ar-SA/audit-log.mdxmarkdown15.9 KB
content/locales/ar-SA/authentication.mdxmarkdown39.8 KB
content/locales/ar-SA/automations.mdxmarkdown31.3 KB
content/locales/ar-SA/aws-amplify.mdxmarkdown14.9 KB
content/locales/ar-SA/aws-lambda.mdxmarkdown18.9 KB
content/locales/ar-SA/aws-rds.mdxmarkdown319 B
content/locales/ar-SA/azure-postgresql.mdxmarkdown344 B
content/locales/ar-SA/azure-static-web-apps.mdxmarkdown12.4 KB
content/locales/ar-SA/blueprint-installer.mdxmarkdown8.4 KB
content/locales/ar-SA/cli-adapters.mdxmarkdown6.7 KB
content/locales/ar-SA/client-advanced.mdxmarkdown17.8 KB
content/locales/ar-SA/client-agent-chat.mdxmarkdown23.0 KB
content/locales/ar-SA/client-data.mdxmarkdown23.8 KB
content/locales/ar-SA/client-entry-points.mdxmarkdown1.6 KB
content/locales/ar-SA/client-overview.mdxmarkdown13.9 KB
content/locales/ar-SA/client-routing.mdxmarkdown7.2 KB
content/locales/ar-SA/client-sync-internals.mdxmarkdown7.3 KB
content/locales/ar-SA/cloneable-saas.mdxmarkdown23.2 KB
content/locales/ar-SA/cloud-sql.mdxmarkdown317 B
content/locales/ar-SA/cloudflare.mdxmarkdown11.9 KB
content/locales/ar-SA/code-agents-ui.mdxmarkdown34.2 KB
content/locales/ar-SA/components.mdxmarkdown51.5 KB
content/locales/ar-SA/context-awareness.mdxmarkdown33.1 KB
content/locales/ar-SA/create-with-an-agent.mdxmarkdown12.2 KB
content/locales/ar-SA/creating-templates.mdxmarkdown26.8 KB
content/locales/ar-SA/cross-app-connect-design.mdxmarkdown1.5 KB
content/locales/ar-SA/cross-app-sso.mdxmarkdown9.7 KB
content/locales/ar-SA/custom-design-system.mdxmarkdown21.6 KB
content/locales/ar-SA/data-programs.mdxmarkdown33.3 KB
content/locales/ar-SA/decisions.mdxmarkdown9.1 KB
content/locales/ar-SA/deno-deploy.mdxmarkdown10.1 KB
content/locales/ar-SA/deploy-an-app.mdxmarkdown7.1 KB
content/locales/ar-SA/deployment-environment-variables.mdxmarkdown21.3 KB
content/locales/ar-SA/deployment.mdxmarkdown13.9 KB
content/locales/ar-SA/dispatch.mdxmarkdown27.3 KB
content/locales/ar-SA/docker.mdxmarkdown11.3 KB
content/locales/ar-SA/doctor.mdxmarkdown3.4 KB
content/locales/ar-SA/drop-in-agent.mdxmarkdown20.8 KB
content/locales/ar-SA/durable-resume.mdxmarkdown15.4 KB
content/locales/ar-SA/embedding-sdk.mdxmarkdown41.3 KB
content/locales/ar-SA/evals.mdxmarkdown13.3 KB
content/locales/ar-SA/extensions.mdxmarkdown34.0 KB
content/locales/ar-SA/external-agents.mdxmarkdown89.3 KB
content/locales/ar-SA/file-uploads.mdxmarkdown13.4 KB
content/locales/ar-SA/getting-started-actions.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started-pages.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started.mdxmarkdown9.7 KB
content/locales/ar-SA/harness-agents.mdxmarkdown22.3 KB
content/locales/ar-SA/internationalization.mdxmarkdown8.2 KB
content/locales/ar-SA/key-concepts.mdxmarkdown42.0 KB
content/locales/ar-SA/koyeb.mdxmarkdown10.2 KB
content/locales/ar-SA/mcp-apps.mdxmarkdown33.7 KB
content/locales/ar-SA/mcp-clients.mdxmarkdown35.0 KB
content/locales/ar-SA/mcp-protocol.mdxmarkdown27.6 KB
content/locales/ar-SA/messaging.mdxmarkdown59.2 KB
content/locales/ar-SA/multi-app-workspace.mdxmarkdown36.2 KB
content/locales/ar-SA/multi-tenancy.mdxmarkdown7.5 KB
content/locales/ar-SA/native-chat-ui.mdxmarkdown21.3 KB
content/locales/ar-SA/neon.mdxmarkdown244 B
content/locales/ar-SA/netlify.mdxmarkdown15.2 KB
content/locales/ar-SA/node-docker.mdxmarkdown878 B
content/locales/ar-SA/node-js.mdxmarkdown8.4 KB
content/locales/ar-SA/notifications.mdxmarkdown16.2 KB
content/locales/ar-SA/observability.mdxmarkdown45.2 KB
content/locales/ar-SA/observational-memory.mdxmarkdown10.9 KB
content/locales/ar-SA/onboarding.mdxmarkdown16.9 KB
content/locales/ar-SA/organizations-teams-permissions.mdxmarkdown5.9 KB
content/locales/ar-SA/package-lifecycle.mdxmarkdown3.0 KB
content/locales/ar-SA/plan-plugin.mdxmarkdown23.0 KB
content/locales/ar-SA/portal.mdxmarkdown636 B
content/locales/ar-SA/postgres.mdxmarkdown487 B
content/locales/ar-SA/pr-visual-recap.mdxmarkdown53.9 KB
content/locales/ar-SA/privacy-and-data-rights.mdxmarkdown6.2 KB
content/locales/ar-SA/processors.mdxmarkdown8.7 KB
content/locales/ar-SA/progress.mdxmarkdown10.7 KB
content/locales/ar-SA/pure-agent-apps.mdxmarkdown5.0 KB
content/locales/ar-SA/real-time-collaboration.mdxmarkdown55.6 KB
content/locales/ar-SA/recorder.mdxmarkdown16.7 KB
content/locales/ar-SA/recurring-jobs.mdxmarkdown23.8 KB
content/locales/ar-SA/render.mdxmarkdown11.2 KB
content/locales/ar-SA/sandbox-adapters.mdxmarkdown18.0 KB
content/locales/ar-SA/security.mdxmarkdown31.5 KB
content/locales/ar-SA/server-database.mdxmarkdown27.6 KB
content/locales/ar-SA/server-middleware.mdxmarkdown7.9 KB
content/locales/ar-SA/server-overview.mdxmarkdown12.2 KB
content/locales/ar-SA/server-plugins.mdxmarkdown9.1 KB
content/locales/ar-SA/server-routes.mdxmarkdown14.3 KB
content/locales/ar-SA/sharing.mdxmarkdown28.6 KB
content/locales/ar-SA/skills-guide.mdxmarkdown27.0 KB
content/locales/ar-SA/ssr-caching.mdxmarkdown7.4 KB
content/locales/ar-SA/supabase.mdxmarkdown264 B
content/locales/ar-SA/syncing-template-changes.mdxmarkdown11.7 KB
content/locales/ar-SA/telemetry.mdxmarkdown21.9 KB
content/locales/ar-SA/template-analytics.mdxmarkdown26.4 KB
content/locales/ar-SA/template-assets.mdxmarkdown31.9 KB
content/locales/ar-SA/template-brain.mdxmarkdown29.7 KB
content/locales/ar-SA/template-calendar-agent.mdxmarkdown10.2 KB
content/locales/ar-SA/template-calendar-developers.mdxmarkdown33.4 KB
content/locales/ar-SA/template-calendar-features.mdxmarkdown14.4 KB
content/locales/ar-SA/template-calendar-integrations.mdxmarkdown6.2 KB
content/locales/ar-SA/template-calendar.mdxmarkdown4.4 KB
content/locales/ar-SA/template-chat-agent.mdxmarkdown4.7 KB
content/locales/ar-SA/template-chat-developers.mdxmarkdown31.3 KB
content/locales/ar-SA/template-chat-features.mdxmarkdown9.9 KB

content/locales/ar-SA/syncing-template-changes.mdx

View on GitHub
---
title: "مزامنة تغييرات القالب"
description: "يقوم agent-native template بسحب تغييرات القالب اللاحقة من الطرف الأول في المنبع إلى تطبيق تم إنشاؤه من قالب، باستخدام دمج ثلاثي حقيقي لكل ملف مقابل خط أساس نقي."
---

# مزامنة تغييرات القالب

ينسخ `agent-native create` قالبًا من الطرف الأول إلى تطبيقك ثم يجعله ملكًا لك - يستبدل اسم التطبيق، ويعيد تسمية `_gitignore`، ويعيد كتابة `package.json`، ويثبّت تبعيات `workspace:*` و`catalog:` على إصدارات محددة، و(في مساحة عمل) يستبدل ملحقات المصادقة والدردشة الموروثة. ومنذ تلك اللحظة يصبح التطبيق تطبيقًا مستقلاً تم إنشاؤه من القالب. الإصلاحات والتحسينات التي تصل إلى القالب في المنبع لا تصل إليه.

لا يقوم `agent-native upgrade` بسد تلك الفجوة. فهو ينقل إصدارات الحزم، ويشغّل تحويلات الاستيراد البرمجية (codemods)، ويحدّث أدلة skills - لكنه لا يمس أبدًا ملفًا تم نسخه من قالب.

`agent-native template` هو النصف المفقود. فهو يعيد جلب القالب بإصدار أحدث، ويعيد تطبيق التحويلات نفسها التي طبّقها `create` بالضبط، ثم يدمج النتيجة في تطبيقك ملفًا تلو الآخر.

قوالب المجتمع خارج مسار المزامنة هذا عمدًا. تسجّل بيانات `agent-native.communityTemplate` مصدر التثبيت فقط، ولا يجلب `agent-native template sync` التغييرات من ذلك المستودع. ثبّت مراجعة محددة لنقطة بداية مستقرة، ثم راجع التغييرات اللاحقة وانقلها يدويًا.

## البدء السريع {#quick-start}

```bash
agent-native upgrade
agent-native template sync
```

يستخدم `sync` افتراضيًا إصدار القالب المطابق لإصدار `@agent-native/core` المثبَّت لديك، لذا فإن تشغيله بعد `upgrade` يُبقي الكود والحزم على الإصدار نفسه.

يؤدي تشغيل `agent-native upgrade` وحده إلى ترقية تبعيات `@agent-native/*` إلى أحدث إصدار (`latest`)، وتثبيتها، وتحديث مهارات السقالة (`skills update scaffold --project`)، وتشغيل typecheck عند توفره. استخدم `agent-native upgrade check` أولًا للحصول على تقرير تشخيصي فقط (doctor-only) حول تجاوزات (overrides) الإطار وترقيعاته (patches) والترقيات المعلَّقة.

**لا** تُصلح ترقية معطوبة باستخدام `pnpm.overrides`، أو `patchedDependencies`، أو تعديلات ضمن `node_modules/@agent-native/*` (خصوصًا core/dispatch)؛ فهذه الحلول تُخفي عدم التوافق الحقيقي بدلًا من حله. إذا فشلت الترقية أو فشل typecheck، أصلح كود التطبيق نفسه أو اسأل، ثم أعد تشغيل الترقية.

ألقِ نظرة قبل أن تدمج:

```bash
agent-native template status
agent-native template diff
```

## كيف يعمل الدمج {#how-the-merge-works}

يحتاج الدمج المفيد إلى ثلاث أشجار، لا شجرتين:

- **الأساس (base)** — القالب النقي كما كان عند إنشاء تطبيقك.
- **نسخة الطرف الآخر (theirs)** — القالب نفسه بالإصدار الذي تُزامن إليه، بعد مروره بخط أنابيب التحويل نفسه.
- **نسختنا (ours)** — تطبيقك كما هو الآن.

بهذه الأشجار الثلاث، يقع كل ملف ضمن حالة واضحة. لم يمسّه المنبع، فيُترك كما هو. أنت لم تلمسه أبدًا، فيُحدَّث تلقائيًا (fast-forward). كلاكما غيّره، فيحصل على علامات تعارض. لا يُستبدل أي شيء لمجرد أنه مختلف.

بدون أساس، لا يمكن أن تعني "المزامنة" سوى الاستبدال الكامل، الذي يتجاهل عملك بصمت أو يتراجع عن تغييرات المنبع.

## خط الأساس {#the-baseline}

تُخزَّن شجرة الأساس كـ git ref في المستودع (repo) الخاص بك:

```txt
refs/agent-native/template-baseline/apps/slides
```

يُكتب هذا باستخدام أدوات git منخفضة المستوى (plumbing) مقابل ملف فهرسة (index) مؤقت يُستغنى عنه. لا يُمس `HEAD` أبدًا، ولا فرعك، ولا فهرستك، ولا شجرة العمل الخاصة بك - تشغيل `template baseline` أثناء التحرير آمن، وتقرأ `git status` بنفس الطريقة قبل وبعد.

عند أول كتابة، تُضاف مواصفات الجلب والدفع (refspecs) لـ `refs/agent-native/*` إلى المستودع البعيد الخاص بك حتى يبقى خط الأساس بعد الاستنساخ (clone). إذا لم يكن التطبيق داخل مستودع git، فإن خط الأساس يعود إلى tarball ضمن `.agent-native/`.

التطبيقات التي أُنشئت قبل وجود بيانات المنشأ (provenance) ليس لها خط أساس. أنشئ واحدًا، ثم زامِن:

```bash
agent-native template baseline
agent-native template sync
```

## بيانات المنشأ {#provenance}

يسجّل `create` ما يحتاجه دمج لاحق داخل `package.json` الخاص بالتطبيق:

```json
{
  "agent-native": {
    "scaffold": {
      "template": "slides",
      "frameworkSkills": "default",
      "templateRef": "@agent-native/core@0.120.3",
      "templateSource": "github",
      "coreVersion": "0.120.3",
      "shape": "workspace"
    }
  }
}
```

`templateRef` هو الوسم الثابت (immutable tag) الذي جُلب منه القالب فعليًا، وهو ما يجعل الأساس قابلًا لإعادة الإنتاج. يحدد `shape` ما إذا كانت تحويلات مساحة العمل تُعاد أثناء التجسيد (materialization).

## الأوامر {#commands}

### status {#status}

```bash
agent-native template status [app]
```

يُبلغ عن المرجع (ref) المسجَّل، وأحدث مرجع متاح، وما إذا كان هناك خط أساس، وعدد الملفات التي غيّرها المنبع، وعدد الملفات التي عدّلتها محليًا.

### diff {#diff}

```bash
agent-native template diff [app] [--to <ref>]
```

فرق موحّد (diff) للقراءة فقط لما تغيّر في المنبع بين خط الأساس لديك والهدف. لا يكتب شيئًا.

### sync {#sync}

```bash
agent-native template sync [app] [--to <ref>] [--dry-run] [--force]
```

يُنفّذ الدمج. تكون القيمة الافتراضية لـ `--to` هي المرجع المطابق للنواة (core) المثبَّتة. يطبع `--dry-run` الخطة دون الكتابة.

يرفض `sync` التشغيل عندما يحتوي دليل التطبيق على تغييرات غير ملتزم بها (uncommitted)، لذا يمكن دائمًا التعافي من دمج سيّئ باستخدام `git checkout`. يتجاوز `--force` هذا الأمر؛ يُفضَّل الالتزام (commit) أولًا.

عندما يكون الدمج نظيفًا، يتقدّم خط الأساس تلقائيًا. أما عند وجود تعارضات فإنه لا يتقدّم عمدًا - راجع `accept`.

### accept {#accept}

```bash
agent-native template accept [app]
```

يُقدِّم خط الأساس بعد أن تحل علامات التعارض. يرفض ذلك ما دامت أي علامة `<<<<<<<` باقية، بحيث لا يتجاوز خط الأساس أبدًا دمجًا لم يُحل بعد، ولا يُدمج علامات التعارض بهدوء في أساسك التالي.

### baseline {#baseline}

```bash
agent-native template baseline [app] [--ref <ref>] [--template <name>]
```

يسجّل خط أساس لتطبيق يسبق وجود بيانات منشأ الإنشاء (scaffold provenance). مرِّر `--ref` عندما تعرف الإصدار الذي أتى منه التطبيق فعليًا؛ فكلما اقترب من الحقيقة، قلّت التعارضات الوهمية التي تنتجها أول مزامنة.

## ما لا يُدمج أبدًا {#what-is-never-merged}

بعض الملفات ملكك بحكم التعريف، وبعضها لا يمكن دمجه بمعنى مفيد:

- الأسرار والتكوين المحلي: `.env`, `.env.local`
- ملفات القفل: `pnpm-lock.yaml`
- المخرجات المُولّدة: `node_modules`, `.output`, `.react-router`, `dist`, `build`
- محتوى مملوك للتطبيق: `learnings.md`، والإدخالات المعلَّقة ضمن `changelog/`

لا تُدمج الملفات الثنائية أبدًا بعلامات. إذا غيّر الطرفان أحدها، تُحفظ نسختك ويُبلَّغ عن الملف للمعالجة اليدوية. تُبلَّغ الروابط الرمزية (symlinks) بدلًا من استبدالها.

## المساهمة بالتغييرات إلى الخلف {#contributing-changes-back}

المزامنة أحادية الاتجاه بالتصميم: المنبع هو المصدر الوحيد للحقيقة لمحتوى القالب، والتحويلات التي يطبّقها `create` ليست قابلة للعكس بشكل تام. استرجاع `{{APP_NAME}}` من اسم تطبيق فعلي هو تخمين، والملفات التي أعاد `create` كتابتها بالكامل - `package.json`، و`netlify.toml`، و`app/root.tsx`، و`server/plugins/auth.ts` - ليس لها عكس دقيق على الإطلاق.

إذا كنت تعمل داخل إطار العمل monorepo وتريد دفع تحسين من جانب التطبيق إلى الخلف نحو قالب، فإن سكربت `contribute:template` يقوم بالتمرير العكسي مع توضيح هذه الحدود بشكل صريح:

```bash
pnpm contribute:template --app <path-to-app> --dry-run
```

يقارن التطبيق الخاص بك بخط أساسه بحيث تكون تغييراتك أنت فقط هي المرشحة، ثم يعكس استبدال العناصر النائبة (placeholder) على هذه الملفات فقط، ويدمجها بدمج ثلاثي الاتجاهات في `templates/<name>/` كتعديلات غير ملتزم بها (unstaged) على الفرع الحالي، ويطبع كل ما رفض لمسه حتى تنقل القصد يدويًا.

## العلاقة بالأوامر الأخرى {#relationship-to-other-commands}

| الأمر                        | ما يُحرِّكه                                               |
| ---------------------------- | --------------------------------------------------------- |
| `agent-native upgrade`       | إصدارات حزم `@agent-native/*`، والاستيرادات، وأدلة skills |
| `agent-native template sync` | الملفات المنسوخة من قالب وقت الإنشاء                      |
| `agent-native eject`         | مكوّن إطار عمل إلى مصدر مملوك للتطبيق، مع بيانات المنشأ   |

`upgrade` و`template sync` متكاملان وآمنان للتشغيل معًا. `eject` هي الحركة المعاكسة - فهي تأخذ ملكية ملف عمدًا، وتُتتبَّع الملفات المُخرَجة (ejected) بشكل منفصل في `agent-native.ejections.json`.
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall