技能 human-docs
📚

human-docs

安全 ⚙️ 外部命令🌐 网络访问📁 文件系统访问

تحويل وثائق الذكاء الاصطناعي إلى أدلة سهلة الفهم

تعتبر وثائق الذكاء الاصطناعي المعقدة صعبة الفهم السريع للبشر. تستخرج هذه المهارة المعلومات الأساسية وتُنشئ ثلاثة تنسيقات سهلة الوصول: ملخصات تنفيذية، وأدلة بدء سريع خطوة بخطوة، ومخططات Mermaid البصرية التي تجعل المفاهيم التقنية سهلة الفهم.

支持: Claude Codex Code(CC)
🥈 78 白银
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“human-docs”。 إنشاء وثائق بشرية لـ ai/architect/app/02_BACKEND_REQUIREMENTS.md

预期结果:

  • تم إنشاء docs/architect/app/02_BACKEND_REQUIREMENTS_SUMMARY.md - نظرة تنفيذية من صفحتين مع الجدول المرجعي السريع
  • تم إنشاء docs/architect/app/02_BACKEND_REQUIREMENTS_QUICKSTART.md - دليل في 5 دقائق مع 5 خطوات للتنفيذ وأوامر التحقق
  • تم إنشاء docs/architect/app/02_BACKEND_REQUIREMENTS_DIAGRAMS.md - 4 مخططات Mermaid عرض تدفق API والمخطط الانتقال بين الحالات

正在使用“human-docs”。 إنشاء مخططات لـ ai/architect/app/ARCHITECTURE.md

预期结果:

  • تم إنشاء docs/architect/app/ARCHITECTURE_DIAGRAMS.md مع 5 مخططات: نظرة عامة على النظام، وتدفق البيانات، والتفاعل بين المكونات، وتدفق العمليات، والمخطط الانتقال بين الحالات

正在使用“human-docs”。 تحديث جميع الوثائق البشرية لمطابقة التغييرات في مجلد ai

预期结果:

  • تم فحص 15 ملف وثائق للذكاء الاصطناعي
  • تم تحديث 12 وثيقة بشرية مقابلة في مجلد docs/
  • تم توليد docs/README.md مع فهرس التنقل

安全审计

安全
v5 • 1/16/2026

Pure documentation transformation skill with no executable code. All 246 static findings are false positives: backticks are markdown inline code formatting, Mermaid diagram syntax is not shell commands, placeholder text like 'command-here' is not real shell execution, and 'weak cryptographic algorithm' patterns are scanner artifacts from words like 'Mermaid' and date formats.

7
已扫描文件
1,620
分析行数
3
发现项
5
审计总数

风险因素

⚙️ 外部命令 (154)
assets/templates/diagrams_template.md:24-36 assets/templates/diagrams_template.md:36-50 assets/templates/diagrams_template.md:50-59 assets/templates/diagrams_template.md:59-74 assets/templates/diagrams_template.md:74-87 assets/templates/diagrams_template.md:87-102 assets/templates/diagrams_template.md:102-115 assets/templates/diagrams_template.md:115-130 assets/templates/diagrams_template.md:130-152 assets/templates/diagrams_template.md:152-165 assets/templates/diagrams_template.md:165-175 assets/templates/diagrams_template.md:175-196 assets/templates/diagrams_template.md:196-197 assets/templates/diagrams_template.md:197-198 assets/templates/diagrams_template.md:198-199 assets/templates/diagrams_template.md:199-200 assets/templates/quickstart_template.md:31-34 assets/templates/quickstart_template.md:34-37 assets/templates/quickstart_template.md:37-39 assets/templates/quickstart_template.md:39-43 assets/templates/quickstart_template.md:43-46 assets/templates/quickstart_template.md:46-50 assets/templates/quickstart_template.md:50-53 assets/templates/quickstart_template.md:53-63 assets/templates/quickstart_template.md:63-70 assets/templates/quickstart_template.md:70-78 assets/templates/quickstart_template.md:78-80 assets/templates/quickstart_template.md:80-88 assets/templates/quickstart_template.md:88-91 assets/templates/quickstart_template.md:91-128 assets/templates/quickstart_template.md:128-140 README.md:11 README.md:37-49 README.md:49-57 README.md:57-65 README.md:65-67 README.md:67 README.md:67-73 README.md:73-75 README.md:75-80 README.md:80-82 README.md:82-85 README.md:85-87 README.md:87-90 README.md:90-92 README.md:92-106 README.md:106-140 README.md:140-141 README.md:141-142 README.md:142-146 README.md:146-147 README.md:147-151 README.md:151 README.md:151-157 README.md:157-185 README.md:185-188 README.md:188-191 README.md:191-197 README.md:197-200 README.md:200-203 README.md:203-209 README.md:209-212 README.md:212-215 README.md:215-244 README.md:244-245 README.md:245-246 README.md:246-247 references/mermaid_examples.md:9-31 references/mermaid_examples.md:31-35 references/mermaid_examples.md:35-42 references/mermaid_examples.md:42-46 references/mermaid_examples.md:46-53 references/mermaid_examples.md:53-59 references/mermaid_examples.md:59-77 references/mermaid_examples.md:77-81 references/mermaid_examples.md:81-95 references/mermaid_examples.md:95-101 references/mermaid_examples.md:101-127 references/mermaid_examples.md:127-133 references/mermaid_examples.md:133-143 references/mermaid_examples.md:143-147 references/mermaid_examples.md:147-159 references/mermaid_examples.md:159-165 references/mermaid_examples.md:165-178 references/mermaid_examples.md:178-193 references/mermaid_examples.md:193-201 references/mermaid_examples.md:201-204 references/mermaid_examples.md:204-205 references/mermaid_examples.md:205-206 references/mermaid_examples.md:206-207 references/mermaid_examples.md:207-212 references/mermaid_examples.md:212-221 references/mermaid_examples.md:221-224 references/mermaid_examples.md:224-246 references/mermaid_examples.md:246-249 references/mermaid_examples.md:249-257 SKILL.md:10 SKILL.md:10 SKILL.md:12 SKILL.md:12 SKILL.md:37-47 SKILL.md:47-49 SKILL.md:49 SKILL.md:49-55 SKILL.md:55-61 SKILL.md:61-68 SKILL.md:68-79 SKILL.md:79-84 SKILL.md:84-87 SKILL.md:87-88 SKILL.md:88-89 SKILL.md:89-90 SKILL.md:90-91 SKILL.md:91-92 SKILL.md:92-100 SKILL.md:100-108 SKILL.md:108 SKILL.md:108-110 SKILL.md:110-125 SKILL.md:125-127 SKILL.md:127-145 SKILL.md:145-147 SKILL.md:147-153 SKILL.md:153-162 SKILL.md:162-165 SKILL.md:165-172 SKILL.md:172-184 SKILL.md:184-213 SKILL.md:213-217 SKILL.md:217-245 SKILL.md:245-249 SKILL.md:249-256 SKILL.md:256-258 SKILL.md:258-264 SKILL.md:264-266 SKILL.md:266-273 SKILL.md:273-278 SKILL.md:278-279 SKILL.md:279-282 SKILL.md:282-290 SKILL.md:290-291 SKILL.md:291-307 SKILL.md:307-312 SKILL.md:312-315 SKILL.md:315-322 SKILL.md:322-328 SKILL.md:328-339 SKILL.md:339-341 SKILL.md:341-368 SKILL.md:368-369 SKILL.md:369-373 SKILL.md:373-374 SKILL.md:374-381 SKILL.md:381-382
🌐 网络访问 (4)
assets/templates/diagrams_template.md:229 references/mermaid_examples.md:261 references/mermaid_examples.md:262 skill-report.json:6
📁 文件系统访问 (1)
skill-report.json:6
审计者: claude 查看审计历史 →

质量评分

68
架构
100
可维护性
87
内容
24
社区
100
安全
91
规范符合性

你能构建什么

إدماج المطورين الجدد بسرعة

إنشاء ملخصات ومخططات من المواصفات التقنية حتى يفهم أعضاء الفريق الجدد بنية النظام دون قراءة آلاف السطور من الوثائق.

إنشاء تقارير تنفيذية

تحويل الوثائق التقنية التفصيلية إلى ملخصات تنفيذية من صفحة واحدة مع مخططات بصرية ت تواصل بنية النظام مع أصحاب المصلحة.

بناء وثائق بصرية

استخراج وتحسين الوثائق الموجودة باستخدام مخططات Mermaid ومخططات التدفق والبنى البصرية لتحسين قابلية القراءة.

试试这些提示

إنشاء جميع التنسيقات 
إنشاء وثائق بشرية لـ ai/architect/app/01_CORE_DATA_PIPELINE.md بما في ذلك الملخص وبدأ سريع والمخططات
إنشاء الملخص فقط 
إنشاء ملخص لـ ai/business/use_cases/CUSTOMER_SEGMENTATION.md مع التركيز على القيمة التجارية والرؤى الرئيسية
إنشاء مخططات بصرية 
إنشاء مخططات Mermaid لـ ai/architect/app/07_WORKFLOWS_AND_DATA_FLOW.md عرض تدفق البيانات والتفاعل بين المكونات
معالجة مجلد دفعياً 
إنشاء ملخصات لجميع المستندات في ai/architect/app/ وتوليد ملف docs/README.md للفهرس

最佳实践

  • احتفظ دائماً بمجلد ai/ كمصدر truth وحدقمعدل مجلد docs/ فقط من خلال هذه المهارة للحفاظ على الاتساق
  • استخدم اصطلاح التسمية لبنية المجلدات المتوازية (FILE_SUMMARY.md, FILE_QUICKSTART.md, FILE_DIAGRAMS.md) لسهولة التنقل
  • أنشئ مخططات للمفاهيم المعمارية المعقدة ولكن حافظ على بساطة المخططات بحد أقصى 7-10 عُقد لكل مخطط

避免

  • التحرير اليدوي لـ docs/ دون تحديث ai/ أولاً يكسر علاقة source of truth
  • إنشاء وثائق بشرية قبل وجود وثائق الذكاء الاصطناعي defeats الغرض من المهارة
  • استخدام مخططات Mermaid معقدة جداً بأكثر من 10 عُقد reduce قابلية القراءة

常见问题

ما هي أدوات الذكاء الاصطناعي التي تدعم هذه المهارة؟
يعمل مع Claude وCodex وClaude Code. جميعها مدعومة بشكل متساوٍ لأنها مهارة توثيق قائمة على الأوامر.
هل يمكنني استخدام هذا مع أي تنسيق وثائق؟
مصمم للوثائق بتنسيق Markdown في مجلد ai/. يعمل بشكل أفضل مع المستندات المنظمة التي لها أقسام وعناوين واضحة.
هل تُعدل هذه المهارة وثائق الذكاء الاصطناعي الأصلية الخاصة بي؟
لا. هذه المهارة تقرأ فقط من مجلد ai/ وتُنشئ ملفات جديدة في مجلد docs/. تظل الوثائق الأصلية دون تغيير.
كيف أقوم بتحديث الوثائق البشرية عند تغيير وثائق الذكاء الاصطناعي؟
استدعِ المهارة باستخدام UPDATE_EXISTING workflow وحدد المسار إلى وثائق الذكاء الاصطناعي المحدثة.
هل يمكنني إنشاء مخططات فقط بدون ملخصات أو أدلة بدء سريع؟
نعم. استخدم DIAGRAMS_ONLY workflow لتوليد المخططات البصرية فقط من أي ملف وثائق.
كيف يختلف هذا عن مهارات التوثيق الأخرى؟
تتميز هذه المهارة بتحويل وثائق الذكاء الاصطناعي الموجودة إلى تنسيقات بشرية بدلاً من إنشاء وثائق جديدة من الصفر.

开发者详情

作者

Brownbull

许可证

MIT

仓库

https://github.com/Brownbull/khujta_ai_business/tree/main/.claude/skills/human-docs

引用

main

文件结构

📁 assets/

📁 templates/

📄 diagrams_template.md

📄 quickstart_template.md

📄 summary_template.md

📁 references/

📄 mermaid_examples.md

📄 README.md

📄 SKILL.md