AgentSkillsCN

custom-project-standards

Go（Golang）后端开发规范。适用于在 Go 项目中进行开发时使用。

SKILL.md
--- frontmatter
name: custom-project-standards
description: Hệ thống tiêu chuẩn dự án đa năng (Standard Platform). Hỗ trợ Frontend, Backend, DevOps với nhiều tùy chọn ngôn ngữ/framework.
allowed-tools: Read, Write, Edit, Find
version: 2.0

Custom Project Standard Platform (v2.1)

OPERATING MECHANISM:

  1. •Auto-Config: Checks for agent-project-config.md in the workspace root. If found, loads Context/Role from there.
  2. •Wizard Mode: If NO config file is found, asks the User to determine Context & Stack.

1. Setup & Context Protocol (Configuration Protocol)

Step 0: Check Config (Highest Priority)

Before asking the user, search for the agent-project-config.md file in the root directory.

If found: Read the Frontmatter of the file to determine:

  • •project_type -> Determine Domain (Frontend/Backend...)
  • •tech_stack -> Determine Stack (NestJS/NextJS...)
  • •role_mode -> Determine Persona (Architect/Implementer...)

Note: If Config exists, SKIP Steps 1 and 2 below, proceed directly to Step 3 (Load Context).

If NOT found: Execute "Wizard" mode (Steps 1 & 2), then propose the user to create a config file for future sessions.

Step 0.5: Analyze Environment (Existing Codebase Protocol)

Before applying any rigid rules or installing new packages, the Agent MUST READ the dependency management files (package.json, go.mod, composer.json, requirements.txt).

Principles:

  1. •Respect Legacy: If the project already uses a specific library (e.g., TypeORM instead of Prisma), USE IT. Do not suggest switching unless explicitly requested.
  2. •Kit Default: Only recommend the Kit's preferred packages (from tech-stack.md) if the project is brand new or lacks that specific capability.

Step 1: Determine Project Type (Domain) - Wizard Mode

Ask the User or auto-detect:

  • • Frontend
  • • Backend
  • • DevOps

Step 2: Determine Language/Framework (Stack) - Wizard Mode

Based on the Domain, further determine:

  • •Frontend: Next.js | Vue | React Native
  • •Backend: NestJS | Python (FastAPI) | Go | Laravel
  • •DevOps: Docker | K8s | AWS

Step 3: Load Context (Important)

After determination (via Config or Wizard), the Agent MUST READ the following documents in order:

  1. •Core Principles (Global): rules/standards/design-principles.md (MUST READ FIRST)
  2. •Domain Rules: (e.g., rules/backend/general.md)
  3. •Stack Rules: (e.g., rules/backend/nestjs/convention.md)
  4. •Role Mode (If available): (e.g., rules/roles/architect.md)

💡 Example: Config is Backend + NestJS: -> Agent reads rules/standards/design-principles.md -> Agent reads rules/backend/general.md -> Agent reads rules/backend/nestjs/convention.md

2. Rules Map

🎨 Frontend

StackRule FileTemplate
Generalrules/frontend/general.md-
Next.jsrules/frontend/nextjs/convention.mdtemplates/frontend/nextjs/
Vue/Nuxtrules/frontend/vue/convention.mdtemplates/frontend/vue/

⚙️ Backend

StackRule FileTemplate
Generalrules/backend/general.md-
NestJSrules/backend/nestjs/convention.mdtemplates/backend/nestjs/
Laravelrules/backend/laravel/convention.md-
Gorules/backend/go/convention.md-
Pythonrules/backend/python/convention.mdtemplates/backend/python/

🚀 DevOps

StackRule File
Dockerrules/devops/docker-standard.md
CI/CDrules/devops/cicd-standard.md

3. Installation Guide

In case the User requests "Create a new project", follow these steps:

  1. •Ask User: "Do you want to create a Frontend or Backend project? Which language?"
  2. •Confirm: "I will create a Next.js project following Custom Standard v2."
  3. •Execute:
    • •Copy structure from templates/frontend/nextjs/ (if available)
    • •Create README.md with content from rules/frontend/nextjs/convention.md
    • •Install required dependencies (check tech-stack.md in the subfolder).