AgentSkillsCN

agent-guidelines

当您需要深入了解项目的核心使命、运营规则或“项目章程”时，可运用此技能，以确保与项目定位及严格的编码标准保持一致。

SKILL.md
--- frontmatter
name: agent-guidelines
description: When you need to understand the project's core mandate, operational rules, or "Constitution". Use this skill to align with the project's identity and strict coding standards.

Agent Guidelines & Operational Rules

1. The "Constitution" & Project Identity

Project Name: NextBlock CMS Mandate: Build a premium, Open-Core Next.js CMS. Core Stack: Next.js (App Router), Supabase, Tailwind CSS, Tiptap v3.

Critical Rules

  1. •Strict Separation: libs/ui and libs/db must be publishable as standalone packages. They cannot depend on apps/nextblock.
  2. •Open-Core Model: The core is open-source; premium extensions are private.
  3. •Distribution: Users get a standalone app via npm create nextblock.

2. Operational Rules (Global Context)

  • •Context First: Before answering complex questions, always check docs/README.md and relevant linked docs.
  • •Strict Types: Always use strict: true TypeScript. No any unless absolutely unavoidable and documented.
  • •Target the App, Not the Template: NEVER edit files in apps/create-nextblock/templates/nextblock-template directly. Always make changes in apps/nextblock (the core app). The template is synced from the core app via scripts.

3. Maintenance Rule: 'Ghost Module Synchronization'

[!IMPORTANT] CRITICAL: Whenever you modify the exports of libs/ecommerce (the private library), you MUST immediately update tools/stubs/libs/ecommerce/index.ts to export the same names (as stubs).

Why? Failure to do this will break the public open-source build which relies on these stubs when the private library is not present.

4. Documentation Access

  • •Use the context7 MCP tool to fetch the latest documentation for Next.js, Supabase, Nx, Tailwind, etc.
  • •Do not guess about API updates; verify with context7 if unsure.

5. Project Knowledge Source (NotebookLM)

[!TIP] Use this for: High-level roadmap, monetization strategy, and architectural "why" questions. Notebook: NextBlock CMS: Roadmap and Monetization Strategy

When you need deep context about the project's direction or specific architectural decisions not explained in the code:

  1. •

    Query the Notebook:

    bash
    python scripts/run.py ask_question.py --notebook-id nextblock-cms-roadmap-and-mone --question "Your question here"
  2. •

    Wait for the answer: It may take 10-20 seconds.

  3. •

    Cite the source: Mention that the info came from the project roadmap notebook.