تخطَّ إلى المحتوى
TakoAPI
العودة إلى المهارات

nodejs-project-arch

بواسطة abczsl520

Coding Agents & IDEs
196التنزيلات وفق ما يذكره clawskills.sh
0المشاهدات
لا إعجاباتسجّل الدخول للإعجاب بهذه المهارة
—لم يُقيَّم بعد
تقييمك

موجز

AI-friendly Node.js architecture — keep files under 400 lines for 70-93% token savings.

الوصف

ما الذي تفعله هذه المهارة

Architecture standards for Node.js projects designed to keep individual files under 400 lines so AI agents can read and edit them without exceeding context limits. Covers route modularization, config externalization via config.json, and a built-in admin dashboard for hot-reloading settings. Applies to REST APIs, H5 games, scrapers, dashboards, and SDK libraries.

Keeping files under 400 lines cuts per-read token cost from ~40K to ~2.7K, giving AI agents 10-15 productive editing rounds instead of 3-5 before context compression degrades output.

متى تستخدمها

  • Refactoring a 3000-line server.js into modular routes and services
  • Starting a new Express API with AI-friendly file size limits
  • Building a Phaser game with canvas logic split across focused modules
  • Setting up a web scraper with runtime-editable config and admin UI
  • Converting hardcoded values to config.json with hot-reload support

مثال على سير العمل

الإدخال

User asks: Refactor my 2500-line Express app into a maintainable, AI-friendly structure

الوكيل
  1. 1

    Identifies project type (API Service) from the signal table

  2. 2

    Reads references/tool.md for the recommended directory layout

  3. 3

    Creates routes/ and services/ directories, splitting logic by domain

  4. 4

    Extracts all hardcoded values into config.json, served via /api/config

  5. 5

    Adds admin.html and routes/admin.js for config editing and hot-reload

الإخراج

Modular project where no file exceeds 400 lines, with a config admin dashboard accessible at /admin

التثبيت

clawhub install abczsl520/nodejs-project-arch

شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.

الروابط