BuilderIO/agent-native / packages/core/docs
agent-native-docs
UnverifiedHow 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.
content/locales/ar-SA/creating-templates.mdx
View on GitHub---
title: "إنشاء النماذج"
description: "كيفية إنشاء ونشر قوالب تطبيقات الوكيل الأصلية الخاصة بك."
---
# إنشاء النماذج
النماذج عبارة عن تطبيقات متكاملة ومتشعبة للوكلاء الأصليين تعمل على حل سير العمل الحقيقي. تم إنشاء قوالب الطرف الأول بنفس سطح إطار العمل الذي تستخدمه: مسارات React لـ UI، وبيانات PostgreSQL عبر Drizzle، وactions للعمليات، وموارد مساحة العمل لسلوك الوكيل، ومزامنة الاستقصاء بحيث يظل الوكيل وUI متوازيين.
استخدم `@agent-native/core` لعقد وقت التشغيل: actions، مكونات server الإضافية، مساعدات قاعدة البيانات، حالة التطبيق، مساعدات التوجيه، ودردشة الوكيل. استخدم `@agent-native/toolkit` لعناصر UI ومساعدات بناء التطبيقات القابلة لإعادة الاستخدام مثل primitives المشتركة، hooks للتنبيه والجوال، منتقيات التاريخ، وفتحات هيكل التطبيق البسيطة. أبق المتغيرات الخاصة بالقالب محلية عندما تعبّر عن سلوك المنتج أو هويته البصرية.
ضع الطبقات الثلاث في الاعتبار عند تحديد مكان الإمكانية:
- **Core - الإطار:** عقد وقت التشغيل والبيانات الأساسي الذي يمكن لكل تطبيق استخدامه.
- **Toolkit - أجزاء اختيارية قابلة لإعادة الاستخدام:** واجهة مستخدم وأنظمة منتج مشتركة يمكن للتطبيقات اعتمادها أو تركيبها أو تفريعها.
- **Templates - تطبيقات اختيارية:** منتجات مجال كاملة مبنية على Core، وغالبًا ما تستخدم Toolkit، ويمكن تفريعها كنقاط بداية.
Toolkit وTemplates اختياريان. القالب ليس الإطار نفسه، وToolkit لا يحل محل Core.
نموذج جيد:
- يعمل على حل سير عمل واحد من البداية إلى النهاية، باستخدام بيانات أولية مفيدة أو تدفق في حالة فارغة.
- يخزن الحالة الدائمة في PostgreSQL/PGlite، وليس ملفات JSON.
- يحدد عمليات التطبيق على أنها `defineAction()` actions.
- يكشف التنقل والاختيار من خلال حالة التطبيق.
- يتم شحن `AGENTS.md` واضح بالإضافة إلى skills المركز لسير العمل غير الواضح.
- تسجيل خطوات الإعداد لمقدمي الخدمة والأسرار المطلوبة.
- يعمل كتطبيق مستقل وكجزء من مساحة عمل متعددة التطبيقات.
## البدء من الدردشة {#start-from-chat}
استخدم نموذج الدردشة عندما تريد تطبيقًا مبسطًا مع توصيلات إطار العمل الموجودة بالفعل:
```bash
npx --yes @agent-native/core@latest create my-template --template chat --standalone
```
بالنسبة لمساحة عمل تحتوي على تطبيقات متعددة، قم بتشغيل المنتقي وقم بتضمين الدردشة مع أي قوالب مجال تريدها:
```bash
npx --yes @agent-native/core@latest create my-platform
```
تمنحك الدردشة مصادقة وسلاسل محادثات متينة وموارد مدعومة بـ PostgreSQL وأدوات وحالة التطبيق وactions ومزامنة الاستقصاء. يمكنك إضافة نموذج المجال والمنتج UI.
إذا لم تكن تنشئ قالب واجهة مستخدم قابلاً لإعادة الاستخدام بعد، فاستخدم [Automation-First Apps](/docs/pure-agent-apps): عرّف الإجراءات، وشغّلها من دون متصفح، وأضف واجهة المستخدم لاحقاً عندما يحتاج سير العمل إلى سطح دائم.
## هيكل المشروع {#project-structure}
يتبع كل قالب نفس التنسيق العام:
<FileTree
id="doc-block-15r9qt6"
title={"بنية مشروع ال template"}
entries={[
{
path: "app/",
note: "واجهة React",
},
{
path: "app/root.tsx",
note: "HTML shell و providers",
},
{
path: "app/routes/",
note: "مسارات ملفات React Router",
},
{
path: "app/components/",
note: "UI الخاصة بال template",
},
{
path: "app/hooks/",
note: "hooks لحالة UI والبيانات",
},
{
path: "actions/",
note: "عمليات defineAction: المصدر الوحيد للحقيقة",
},
{
path: "server/db/schema.ts",
note: "مخطط Drizzle",
},
{
path: "server/plugins/db.ts",
note: "migrations إضافية",
},
{
path: "server/plugins/",
note: "تكاملات بدء التشغيل",
},
{
path: "server/routes/api/",
note: "routes مخصصة فقط عندما لا تكفي actions",
},
{
path: "shared/types.ts",
note: "client/server types مشتركة",
},
{
path: ".agents/skills/",
note: "<skill>/SKILL.md: إرشادات agent لل workflows المعقدة",
},
{
path: "AGENTS.md",
note: "تعليمات agent خاصة بال template",
},
{
path: "package.json",
},
{
path: "react-router.config.ts",
},
{
path: "vite.config.ts",
},
]}
/>
لا تقم بإضافة دليل `data/` لحالة التطبيق. تنتمي بيانات التطبيق الدائمة إلى PostgreSQL/PGlite، ويقرأها UI من خلال actions أو معالجات الخادم المكتوبة.
تربط المناطق الأربع لكل قالب معًا من خلال سطح عمل مشترك واحد وقاعدة بيانات PostgreSQL/PGlite واحدة - الوكيل وUI شريكان متساويان في نفس العمليات:
<Diagram id="doc-block-7npsk8" title={"كيف تتصل المناطق الأربع للقالب"} summary={"يصل كل من واجهة المستخدم والوكيل إلى PostgreSQL/PGlite من خلال نفس الإجراءات؛ حالة التطبيق ومزامنة الاستقصاء تحافظ على توافقهما."}>
```html
<div class="diagram-tmpl">
<div class="diagram-col">
<div class="diagram-node">
واجهة React<br /><small class="diagram-muted"
>app/routes · المكونات</small
>
</div>
<div class="diagram-node">
Agent<br /><small class="diagram-muted">AGENTS.md · skills</small>
</div>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-panel center">
<span class="diagram-pill accent">الإجراءات</span
><small class="diagram-muted">defineAction()</small>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-box" data-rough>
PostgreSQL عبر Drizzle<br /><small class="diagram-muted"
>additive schema</small
>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↻</div>
<div class="diagram-pill ok">مزامنة بالاستقصاء</div>
</div>
```
```css
.diagram-tmpl {
display: flex;
align-items: center;
gap: 12px;
flex-wrap: wrap;
}
.diagram-tmpl .diagram-col {
display: flex;
flex-direction: column;
gap: 10px;
}
.diagram-tmpl .diagram-arrow {
font-size: 22px;
line-height: 1;
}
.diagram-tmpl .center {
display: flex;
flex-direction: column;
align-items: center;
gap: 4px;
}
```
</Diagram>
## بيانات النموذج في PostgreSQL {#data-models}
حدد جداول المجال باستخدام مساعدات Drizzle في إطار العمل بحيث تستخدم المخططات PostgreSQL وPGlite:
```ts filename="server/db/schema.ts"
import {
table,
text,
integer,
now,
ownableColumns,
createSharesTable,
} from "@agent-native/core/db/schema";
export const projects = table("projects", {
id: text("id").primaryKey(),
title: text("title").notNull(),
status: text("status", {
enum: ["draft", "active", "archived"],
})
.notNull()
.default("draft"),
sortOrder: integer("sort_order").notNull().default(0),
...ownableColumns(),
createdAt: text("created_at").notNull().default(now()),
updatedAt: text("updated_at").notNull().default(now()),
});
export const projectShares = createSharesTable("project_shares");
```
يجب أن تكون تغييرات المخطط إضافية. بالنسبة إلى الجداول والأعمدة الجديدة الخاصة
بالتطبيق، استخدم `drizzle-kit generate` لإنشاء SQL قابل للمراجعة ضمن
`server/db/migrations/<id_name>.sql`، ثم حمّله عبر
`runDrizzleMigrations()` من خطوة الإصدار في عمليات نشر Node.js. لا يوفر
Cloudflare Workers/Pages وبيئات edge الأخرى لا توفر نظام ملفات قابلًا للنشر، لذا ضمّن SQL المُنشأ في
حزمة العامل ومرّره إلى `runMigrations()` هناك. احتفظ بـ `runMigrations()` للتاريخ
المكتوب يدويًا والحالات الخاصة. لا تستخدم مطلقًا SQL أو `drizzle-kit push` أو
إعادة تسمية الجداول أو إسقاط الأعمدة.
لقراءة التطبيق وكتابته، استخدم منشئ الاستعلامات والمشغلات المحمولة Drizzle من `drizzle-orm`. لا تكتب رمز المنتج باستخدام SQL الخام عندما يتمكن Drizzle من التعبير عن الاستعلام، واستخدم مساعدات المخطط من `@agent-native/core/db/schema` في القوالب.
```ts filename="server/plugins/db.ts"
import { runMigrations } from "@agent-native/core/db";
export default runMigrations(
[
{
version: 1,
sql: `CREATE TABLE IF NOT EXISTS projects (
id TEXT PRIMARY KEY,
title TEXT NOT NULL,
status TEXT NOT NULL DEFAULT 'draft',
sort_order INTEGER NOT NULL DEFAULT 0,
owner_email TEXT NOT NULL,
org_id TEXT,
visibility TEXT NOT NULL DEFAULT 'private',
created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
)`,
},
],
{ table: "my_app_migrations" },
);
```
استخدم مستندات [Database](/docs/server-database) و[Security](/docs/security) قبل إضافة المخططات التي تحتوي على بيانات المستخدم أو بيانات المؤسسة.
## حدد العمليات كـ الإجراءات {#actions}
الإجراءات هي المصدر الوحيد لحقيقة سلوك التطبيق. يستدعيها الوكيل كأدوات، وتستدعيها الواجهة الأمامية من خلال الخطافات، ويمكن للتطبيقات الأخرى الوصول إليها من خلال MCP/A2A.
<AnnotatedCode
id="doc-block-15dfand"
title="actions/create-project.ts"
filename="actions/create-project.ts"
language="ts"
code={
'import { defineAction } from "@agent-native/core/action";\nimport { getDb } from "../server/db/index.js";\nimport { nanoid } from "nanoid";\nimport { z } from "zod";\nimport * as schema from "../server/db/schema";\n\nexport default defineAction({\n description: "Create a project.",\n schema: z.object({\n title: z.string().min(1).describe("Project title"),\n }),\n run: async ({ title }, ctx) => {\n const db = getDb();\n const id = nanoid();\n await db.insert(schema.projects).values({\n id,\n title,\n ownerEmail: ctx.userEmail,\n orgId: ctx.orgId,\n });\n return { id, title };\n },\n});'
}
annotations={[
{
lines: "2",
note: "`getDb` is created per app via `createGetDb(schema)` in `server/db/index.ts`.",
},
{
lines: "8",
label: "سطح الأداة",
note: "`description` هو ما يقرأه الوكيل ليقرر متى يتم استدعاء هذا الإجراء كأداة.",
},
{
lines: "9-11",
label: "عقد typed",
note: "يقوم zod `schema` واحد بالتحقق من الإدخال من agent وواجهة المستخدم وHTTP وMCP وA2A.",
},
{
lines: "18-19",
label: "كتابة محددة النطاق",
note: "ختم `ownerEmail` / `orgId` من `ctx` بحيث يتم تحديد نطاق الصف بشكل صحيح لعمليات التحقق من المشاركة والوصول.",
},
]}
/>
استخدم `http: { method: "GET" }` أو `readOnly: true` لـ actions للقراءة فقط. استخدم `parallelSafe: true` فقط لتحويل actions الآمن للتشغيل بشكل متزامن مع استدعاءات أداة التشغيل نفسها. استخدم `toolCallable: false` لنطاق الانفجار العالي actions الذي لا ينبغي تشغيله من أدوات وضع الحماية.
## قم ببناء UI {#ui}
توجد المسارات في `app/routes/` وتستخدم توجيه الملفات React Router v8. الاستعلام عن البيانات من خلال معالجات actions أو API، وجعل الطفرات متفائلة بشكل افتراضي.
```tsx
import {
useActionMutation,
useActionQuery,
} from "@agent-native/core/client/hooks";
export default function ProjectsPage() {
const { data: projects = [] } = useActionQuery("list-projects", {});
const create = useActionMutation("create-project");
return (
<button onClick={() => create.mutate({ title: "Launch plan" })}>
New project ({projects.length})
</button>
);
}
```
قم بتوصيل المزامنة المباشرة مرة واحدة بالقرب من غلاف التطبيق حتى يتم تحديث ذاكرة التخزين المؤقت للاستعلام React عندما يقوم الوكيل أو علامة تبويب أخرى أو إجراء بتغيير البيانات:
```tsx
import { useDbSync } from "@agent-native/core/client/hooks";
import { useQueryClient } from "@tanstack/react-query";
export function AppSync() {
const queryClient = useQueryClient();
useDbSync({ queryClient });
return null;
}
```
**الوعد الأصلي للوكيل: تظهر كتابات الوكيل في UI بدون تحديث يدوي. ** `useActionQuery` هو المسار السهل - يتم إعادة جلب كل خطاف عندما يصدر إجراء متحور `source: "action"`. إذا وصلت إلى `useQuery` الأولي باستخدام مفتاح مخصص (على سبيل المثال، مساعد عميل منخفض المستوى يقرأ حالة التكامل)، فقم بطي العداد لكل مصدر في queryKey للتحديثات المستهدفة:
```tsx
import { useChangeVersions } from "@agent-native/core/client/hooks";
const v = useChangeVersions(["dashboards", "action"]);
useQuery({
queryKey: ["dashboard", id, v],
queryFn: () => fetchDashboard(id),
placeholderData: (prev) => prev, // no flicker on refetch
});
```
المصادر الشائعة: `"action"` (كل إجراء وكيل ناجح - الإجراء الاحتياطي الموثوق به)، `"app-state"`، `"settings"`، بالإضافة إلى أي مصدر موارد مخصص يصدره متجرك عبر `recordChange`. شاهد مهارة `real-time-sync` للتعرف على النمط الكامل.
## أضف حالة التطبيق {#application-state}
حالة التطبيق هي الطريقة التي يعرف بها الوكيل ما يراه المستخدم. على الأقل أضف:
- خطاف UI يكتب حالة `navigation` الدلالية عند تغيير المسارات أو السجلات المحددة أو علامات التبويب النشطة أو تحديدات المحرر.
- إجراء `view-screen` يقرأ تلك الحالة ويعيد لقطة الشاشة الحالية.
- إجراء `navigate` يكتب أمر `navigate` لمرة واحدة ليستهلكه UI.
استخدم `useAgentRouteState` للربط UI حتى تظل عمليات الكتابة في حالة التطبيق، وقراءة الأوامر على مستوى علامة التبويب، والحذف بعد القراءة، وحماية الأوامر المكررة متسقة:
```tsx
import { useAgentRouteState } from "@agent-native/core/client/navigation";
import { TAB_ID } from "@/lib/tab-id";
export function useNavigationState() {
useAgentRouteState({
browserTabId: TAB_ID,
requestSource: TAB_ID,
getNavigationState: ({ pathname, searchParams }) => ({
view: pathname === "/" ? "home" : pathname.slice(1),
selectedId: searchParams.get("id"),
}),
getCommandPath: (command: any) => command.path ?? "/",
navigateOptions: { replace: true, flushSync: true },
});
}
```
احتفظ بعوامل التصفية القابلة للمشاركة في معلمات استعلام URL. يعرض إطار العمل للوكيل المفاتيح التي تعلنها في `urlQueryKeys` الخاص بـ `AgentSidebar` باسم `<current-url>` (القيم الأخرى تظهر كـ `<redacted>`) ويمكن للوكيل المدمج تغييرها باستخدام `set-search-params`؛ يجب أن يحمل `navigation` المعرفات الدلالية والأسماء المستعارة، وليس نسخة ثانية من سلسلة الاستعلام الكاملة.
للتنقل في التطبيق، فضل أمر `navigate` الذي يتضمن نفس المصدر
`path` عندما يكون URL معروفًا. ولا تكتب أيضًا `__set_url__` لنفس الحركة؛
هذا المفتاح محجوز لأدوات إطار العمل URL وتغييرات مرشح URL فقط.
```ts filename="actions/navigate.ts"
import { defineAction } from "@agent-native/core/action";
import { writeAppState } from "@agent-native/core/application-state";
import { z } from "zod";
export default defineAction({
description: "Navigate the UI.",
schema: z.object({
view: z.enum(["home", "project"]),
projectId: z.string().optional(),
path: z.string().optional(),
}),
run: async (args) => {
await writeAppState("navigate", args);
return { ok: true };
},
});
```
راجع [Context Awareness](/docs/context-awareness) للتعرف على النمط الكامل.
## استخدم مسارات API باعتدال {#api-routes}
يُفضل actions لعمليات التطبيق. قم بإنشاء مسارات Nitro مخصصة فقط للأسطح التي لا يمكن أن تكون actions نظيفة:
- تحميل ملف أو تدفق ثنائي.
- الصفحات العامة المجهولة وwebhooks.
- استدعاءات OAuth ومعالجات البروتوكول الخاصة بالموفر.
- المحتوى العام الذي يعرضه الخادم.
يجب على المسارات المخصصة التي تلامس البيانات القابلة للملكية استدعاء `getSession(event)` والتفاف عمل قاعدة البيانات في `runWithRequestContext({ userEmail, orgId }, fn)` قبل استخدام مساعدي الوصول.
## اكتب تعليمات الوكيل {#write-agents-md}
`AGENTS.md` هي خريطة الوكيل لتطبيقك - ملف صغير قابل للتصفح مع
سطر الغرض، والقواعد الأساسية، ومفاتيح حالة التطبيق، وجدول الإجراءات، وskills
الفهرس:
```markdown
# القالب الخاص بي
One workspace for projects, tasks, and notes.
## القواعد الأساسية
- Data lives in PostgreSQL عبر Drizzle. Use actions for all writes; schema is additive.
- Use `view-screen` before acting on "this project" if the screen is unclear.
## حالة التطبيق
- `navigation.view`: `home` | `project`
- `navigation.projectId`: selected project on a project page
## الإجراءات
| Action | Purpose |
| ---------------- | ------------------------ |
| `list-projects` | List accessible projects |
| `create-project` | Create a project |
```
قم بتحديث `AGENTS.md` كلما أضفت إجراءً جديدًا أو مسارًا أو مفتاح حالة أو متكررًا
سير العمل. [Writing Agent Instructions](/docs/writing-agent-instructions) هو
الدليل الكامل — كيفية إبقاء `AGENTS.md` قابلاً للتصفح، وما ينتمي إلى كل من العناصر الأربعة
أسطح الإرشادات وكيفية صياغة المهارات وأوصاف الأدوات حتى يكون الوكيل
يقوم بتشغيلها بشكل موثوق.
## أضف Skills {#skills}
استخدم skills للأنماط التفصيلية التي من شأنها تضخم `AGENTS.md`: API الخاصة بالموفر، أو تنسيقات الاستيراد/التصدير، أو تدفقات التحرير المعقدة، أو مصطلحات المجال.
```markdown
---
name: project-imports
description: How to import projects from the legacy CSV export.
---
# واردات المشروع
Use this skill when the user uploads a legacy project CSV.
## القواعد
- Validate required columns before creating rows.
- Use `create-project` for each project so ownership and sync are correct.
- Save rejected rows as a note attached to the import summary.
```
قم بتخزين القالب skills في `.agents/skills/<name>/SKILL.md`. إذا كان من المفترض أن يتمكن المستخدمون من تعديل الإرشادات في وقت التشغيل، فاعرضها من خلال موارد مساحة العمل أيضًا.
## تسجيل خطوات الإعداد {#onboarding}
إذا كان القالب يحتاج إلى مفتاح API أو اتصال OAuth أو حساب الموفر، فقم بتسجيل خطوة الإعداد بدلاً من دفن المتطلبات في README.
```ts
// server/plugins/onboarding.ts
import { defineNitroPlugin } from "@agent-native/core/server";
import { registerOnboardingStep } from "@agent-native/core/onboarding";
export default defineNitroPlugin(() => {
registerOnboardingStep({
id: "github",
title: "Connect GitHub",
description: "Needed to import repositories and pull requests.",
order: 100,
methods: [
{
id: "token",
kind: "form",
primary: true,
label: "Save token",
payload: {
fields: [
{ key: "GITHUB_TOKEN", label: "GitHub token", secret: true },
],
},
},
],
isComplete: () => !!process.env.GITHUB_TOKEN,
});
});
```
راجع [Onboarding & API Keys](/docs/onboarding).
## اجعلها جاهزة للاستخدام في مساحة العمل {#workspace-ready}
يجب أن تتلاءم القوالب بشكل طبيعي مع [Multi-App Workspaces](/docs/multi-app-workspace)، ويتم تنسيقها عادةً بواسطة [Dispatch](/docs/dispatch).
قائمة التحقق:
- قم بتثبيت A2A من خلال البرنامج الإضافي للدردشة مع وكيل إطار العمل أو `mountA2A()` حتى تتمكن التطبيقات الشقيقة من الاتصال بوكيلك.
- احتفظ بأوصاف بطاقة الوكيل محددة بدرجة كافية حتى تتمكن Dispatch من توجيه العمل بدقة.
- قم بتسجيل الأسرار/الإعداد المطلوبة حتى يظهر الإعداد في الشريط الجانبي ويمكن لـ Dispatch إدارة بيانات الاعتماد المشتركة.
- احتفظ بالتعليمات الشاملة في مساحة العمل `AGENTS.md` أو موارد مساحة العمل، ولا يتم نسخها في كل تطبيق.
- استخدم مساعدي المشاركة/الوصول لجميع الموارد القابلة للملكية حتى تظل مساحات العمل على مستوى المؤسسة معزولة.
## نشر نموذج {#publishing}
قبل المشاركة:
1. قم بتشغيل `pnpm install` و`pnpm typecheck` واختبارات القالب.
2. تحقق من أنه يعمل مع عدم تكوين مفاتيح الموفر الاختيارية.
3. تحقق من المصادقة والمشاركة وعزل البيانات الخاصة بمستخدمين.
4. يتطلب المستند env vars وخطوات الإعداد.
5. قم بتضمين أمثلة أو صفوف أولية من خلال عمليات الترحيل الإضافية، وليس ملفات بيانات وقت التشغيل المتعقبة.
تُثبَّت قوالب المجتمع مباشرة من مستودع GitHub عام. ضع تطبيق Agent-Native في جذر المستودع:
```bash
npx --yes @agent-native/core@latest create my-app --template community:owner/repo
```
أضف `#branch` أو `#tag` أو `#commit` لتثبيت مراجعة محددة:
```bash
npx --yes @agent-native/core@latest create my-app --template community:owner/repo#v1.0.0
```
تنزّل CLI المصدر فقط، ولا تثبّت الاعتماديات أو تشغّل برامج القالب. قوالب المجتمع شيفرة من جهات خارجية؛ راجع المستودع والترخيص والاعتماديات وبرامج التثبيت قبل تشغيل `pnpm install`.
للإدراج في الكتالوج، ضمّن تطبيقًا كاملًا في الجذر، ومستودعًا عامًا بترخيص وملف README للإعداد، واعتمادًا على `@agent-native/core`، وفحوص أنواع واختبارات ناجحة. العرض المستضاف ولقطة الشاشة اختياريان.
[أرسل قالب مجتمع](https://github.com/BuilderIO/agent-native/issues/new?template=community-template.yml) عندما يصبح المستودع جاهزًا. تبقى إدراجات المجتمع منفصلة عن الكتالوج الرسمي ويصونها مؤلفوها.
## المساهمة في إطار العمل monorepo {#contributing}
### اختبر تغييرات إطار العمل غير المنشورة {#test-unpublished-framework-changes}
عندما تعمل داخل إطار عمل monorepo وتحتاج إلى إنشاء
مساحة العمل لاستخدام تغييرات الحزمة أو القالب غير المنشورة، قم بتشغيل الإنشاء باستخدام
علامة الحزمة المحلية:
```bash
AGENT_NATIVE_CREATE_USE_LOCAL_CORE=1 pnpm --filter @agent-native/core create my-platform
```
تربط مساحة العمل التي تم إنشاؤها `@agent-native/core` المحلي و
حزم `@agent-native/dispatch`، لذلك تتغير إلى Core APIs، ومساحة عمل Dispatch
يمكن اختبار السلوك أو قوالب الطرف الأول قبل النشر. الحزمة
تنشئ البرامج النصية `prepack` `dist` قبل الارتباط، مما يحافظ على ما تم إنشاؤه
تشير مساحة العمل إلى مخرجات البناء الحالية.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |