AgentSkillsCN

repo-navigator

在进入任务时快速定位Sage仓库，选择正确的编辑或验证路径。当文件所有权尚不明确、需要将某项变更映射至相应层级，或在决定哪些命令必须运行时，可使用此功能。

SKILL.md
--- frontmatter
name: repo-navigator
description: Navigate the Sage repository quickly and choose correct edit/verification paths. Use at task start when file ownership is unclear, when mapping a change to layers, or when deciding which command gates must run.

repo-navigator

Objective

Route work to the correct files and verification commands in under 60 seconds.

Fast Start

  1. •Read docs/agentic/AGENT-START.md.
  2. •Map request to layer:
    • •src/shared: reusable primitives and architecture policy
    • •src/core: runtime logic, orchestration, memory
    • •src/bot: Discord adapters, handlers, commands
    • •src/app: composition/bootstrap
    • •src/scripts: operational checks and maintenance scripts
  3. •Identify blast radius (imports, tests, docs, CI scripts).
  4. •Select verification depth:
    • •Small/local change: focused test or check
    • •Cross-layer or policy change: full npm run check

Verification Matrix

  • •Docs/index or link updates: npm run docs:check
  • •Import/layer changes: npm run arch:check
  • •Code changes with possible behavior impact: npm run check

Guardrails

  • •Preserve user-facing behavior unless explicitly requested.
  • •Prefer existing conventions over new structure.
  • •Keep edits minimal and reversible.

Output Contract

  • •State chosen files, why they were selected, and which verification commands were run.
  • •Call out assumptions when ownership was ambiguous.