AgentSkillsCN

repo-orientation

在新建仓库(或经历大规模重构之后)开始工作时使用,用于梳理规范、命令与安全防线。切勿直接实现功能,只需产出一份仓库操作手册。

SKILL.md
--- frontmatter
name: repo-orientation
description: Use when starting work in a new repo (or after a big refactor) to map conventions, commands, and guardrails. Do NOT implement features; only produce a repo playbook.

Goal: Create a short, repo-specific playbook that other skills can follow reliably.

Checklist:

  • Identify backend and frontend build commands (if both exist)
  • Identify test commands (unit/integration/e2e) and how to run a single test
  • Identify lint/format commands (dotnet format/analyzers, eslint/prettier, etc.)
  • Identify local run/debug commands and required env/config
  • Identify solution/app structure:
    • key projects/packages
    • where API contracts live (controllers/endpoints, DTOs, OpenAPI, generated clients)
    • where DB migrations live (EF Core, Flyway, Liquibase, raw SQL)
  • Identify CI workflows:
    • required checks names
    • how CI runs build/test/lint
    • any deployment workflows and environments
  • Identify security/quality tooling:
    • CodeQL, dependency scanning, secret scanning
    • static analyzers, SAST/DAST, code coverage gates
  • Identify patterns/conventions:
    • error handling + logging style
    • auth/authz approach
    • folder naming, architecture boundaries
    • feature flags, background jobs, message buses

Output format:

Repo Playbook

Commands

  • Build:
  • Test:
  • Lint/Format:
  • Local run:

Structure

  • Key folders/projects:
  • API contract boundary:
  • DB/migrations:

CI & Guardrails

  • Workflows:
  • Required checks:
  • Release/deploy notes:

Do/Don't

  • Do:
  • Don't:

Finish with:

  • Repo Playbook
  • Unknowns/risks