技能 building-agents
🤖

building-agents

低風險 ⚡ 包含腳本📁 檔案系統存取⚙️ 外部命令

إنشاء وكلاء Claude Code

يتطلب بناء وكلاء Claude Code فهم معايير المخططات وأفضل ممارسات الأمان وتكوين الأدوات بشكل صحيح. توفر هذه المهارة إرشادات متخصصة لإنشاء وكلاء متينين وآمنين يتبعون أنماطًا راسخة وتتضمن التحقق من الصحة لضمان الجودة قبل النشر.

支援: Claude Code(CC)
🥉 76 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「building-agents」。 إنشاء وكيل جديد لمراجعة الكود

預期結果:

  • تم إنشاء الوكيل: code-reviewer
  • اللون: #3498DB (الأزرق - مجال التحليل)
  • الأدوات: Read وGrep وGlob (حد أدنى، للقراءة فقط)
  • النموذج: sonnet (أداء متوازن)
  • الخطوات التالية: تشغيل التحقق من الصحة مع python3 scripts/validate-agent.py

正在使用「building-agents」。 راجع وكيل موجود مقابل أفضل الممارسات

預期結果:

  • التوافق مع المخطط: نجح
  • التسمية: نجح (أحرف صغيرة مع شرطات، 12 حرفًا)
  • الأدوات: تحذير - تم تضمين Bash بدون إرشادات التحقق من صحة الإدخال
  • التوثيق: نجح (قسم القدرات وسير العمل موجود)
  • التوصية: أضف قسم التحقق من صحة الإدخال أو أزل Bash من الأدوات

安全審計

低風險
v5 • 1/16/2026

Pure prompt-based skill for Claude Code agent creation. Static findings are false positives: hex color codes misidentified as MD5 hashes, markdown code blocks misidentified as shell backticks, and CLI command examples misidentified as reconnaissance. The skill includes a Python validation script that safely reads user-specified files without network access or credential handling.

9
已掃描檔案
3,548
分析行數
4
發現項
5
審計總數
低風險問題 (1)
SKILL.md:5
Bash tool in allowed-tools
The skill declares Bash in allowed-tools for running validation scripts. This is documented, expected behavior for an agent-builder skill, and runs within Claude Code's sandbox.

風險因素

⚡ 包含腳本 (1)
scripts/validate-agent.py:1-188
📁 檔案系統存取 (1)
SKILL.md:33-35
⚙️ 外部命令 (1)
SKILL.md:441-451
審計者: claude 查看審計歷史 →

品質評分

68
架構
100
可維護性
87
內容
21
社群
88
安全
96
規範符合性

你能建構什麼

بناء وكلاء الإضافات

إنشاء وكلاء متخصصين لإضافتك باتباع الأنماط والألوان اصطلاحات المخطط الراسخة

توحيد جودة الوكلاء

التأكد من أن جميع وكلاء الفريق يستوفون متطلبات التوافق مع المخطط ومعايير الأمان ومتطلبات التوثيق

توسيع قدرات Claude

إنشاء وكلاء فرعيين مخصصين لمجالات محددة مثل مراجعة الكود أو تحليل الأمان أو التوثيق

試試這些提示

إنشاء وكيل جديد 
إنشاء وكيل جديد باسم code-reviewer مع سمة اللون الأزرق. يجب أن يراجع الكود بحثًا عن الأخطاء والمشاكل الأمنية. استخدم أدوات Read وGrep وGlob ونموذج sonnet.
مراجعة وكيل موجود 
راجع وكيل security-auditor باستخدام قائمة التحقق من الوكيل. تحقق من التوافق مع المخطط والأمان وجودة المحتوى. قدم درجة وتوصيات.
ترحيل وكيل قديم 
رحّل my-agent.md من المخطط القديم إلى المعايير الحالية. تحقق من حالة التحقق من الصحة وطبّق أنماط التحديث لأذونات الأدوات ووضوح الوصف.
إنشاء من القالب 
إنشاء ملف وكيل جديد باستخدام قالب الوكيل. سماه test-runner باللون الأحمر. يجب أن ينفذ الاختبارات ويُبلغ عن النتائج. قم بتضمين أداة Bash لتشغيل أوامر الاختبار.

最佳實務

  • ابدأ بأذونات أدوات دنيا وأضف فقط عند الضرورة
  • استخدم نص التحقق من الصحة قبل الالتزام بالوكلاء لاكتشاف مشاكل المخطط
  • اتبع اصطلاحات الألوان المجال للاتساق البصري عبر الوكلاء المرتبطة

避免

  • تضمين أداة Task في الوكلاء (لا يمكن للوكلاء الفرعيين إنشاء وكلاء فرعيين أخرى)
  • الإفراط في منح الأذونات للأدوات مثل منح Bash بدون التحقق من صحة الإدخال
  • إنشاء وكلاء بوصف غامض لا يحدد وقت الاستدعاء

常見問題

ما الأدوات التي يجب أن أمنحها لوكيلي؟
ابدأ بالحد الأدنى باستخدام Read وGrep ��Glob. أضف Write/Edit فقط لتعديل الملفات. قم بتضمين Bash فقط لتنفيذ الاختبار أو عمليات النظام. تحقق دائمًا من صحة الإدخال عندما يكون Bash مُمكّنًا.
هل يمكن للوكلاء إنشاء وكلاء آخرين؟
لا. لا يمكن للوكلاء الفرعيين استخدام أداة Task. للتنسيق، أنشئ مهارة بدلاً من ذلك (المهارات تعمل في الخيط الرئيسي ويمكنها استخدام Task).
كيف أتحقق من صحة وكيل؟
تشغيل نص التحقق من الصحة: python3 agent-builder/skills/building-agents/scripts/validate-agent.py path/to/agent.md. يتحقق من بناء جملة YAML واصطلاحات التسمية والحقول المطلوبة وأذونات الأدوات.
هل بياناتي آمنة مع هذه المهارة؟
نعم. لا يصلح النص إلا إلى الملفات التي تحددها. يستخدم نص التحقق من الصحة تحليل YAML آمن ولا يُجري طلبات شبكة أو يجمع بيانات حساسة.
كيف يختلف هذا عن المهارات أو الأوامر؟
الوكلاء هم وكلاء فرعيون متخصصون ذوو سياق مستقل، يتم استدعاؤهم صراحةً عبر Task. تستدعى المهارات تلقائيًا بناءً على السياق. الأوامر هي مهام سير عمل يُفعّلها المستخدم مع معلمات.
أي نموذج يجب أن أختار؟
استخدم haiku للمهام البسيطة (الملخصات والبحث)، وsonnet لمعظم المهام (متوازن)، وopus للاستدلال المعقد. طابق تعقيد النموذج مع متطلبات المهمة.

開發者詳情

授權

MIT

儲存庫

https://github.com/C0ntr0lledCha0s/claude-code-plugin-automations/tree/main/agent-builder/skills/building-agents

引用

main

檔案結構

📁 references/

📄 agent-examples.md

📄 agent-update-patterns.md

📄 color-palette.md

📄 migration-guide.md

📁 scripts/

📄 validate-agent.py

📁 templates/

📄 agent-checklist.md

📄 agent-template.md

📄 SKILL.md