AgentSkillsCN

atlas-context-sources

为 Atlas 单体仓库相关工作寻找并优先筛选权威的背景资料来源。适用于处理 Atlas 架构、启动器/运行器/Web 行为、协议与数据格式、API 路由、身份认证、发布流程等议题时使用；亦可在 Codex 需要回答“我该先从哪里入手？”这一问题时，为实施、调试、评审或记录变更提供参考依据。

SKILL.md
--- frontmatter
name: atlas-context-sources
description: Find and prioritize authoritative context sources for Atlas monorepo work. Use when requests involve Atlas architecture, launcher/runner/web behavior, protocol and data formats, API routes, authentication, release flow, or when Codex needs to answer "where should I look first?" before implementing, debugging, reviewing, or documenting changes.

Atlas Context Sources

Use this skill to avoid shallow context gathering. Start with executable truth, then layer architecture and external docs.

Source Priority

  1. •Executable truth in this repository.
  2. •Atlas design and developer docs.
  3. •Git history for behavior changes.
  4. •Official external docs matching pinned versions.
  5. •Community posts only when primary sources are insufficient.

Prefer code over prose when they disagree. Treat docs as intent, not ground truth.

Workflow

  1. •Classify the request domain using references/domain-map.md.
  2. •Open at least one executable source and one supporting doc from that domain.
  3. •Check pinned versions (package.json, crate Cargo.toml) before reading external docs.
  4. •Reconcile inconsistencies and state what source won and why.
  5. •Summarize with exact file paths, unresolved questions, and confidence.

Minimum Evidence Bar

  • •Bug fix: failing path in code + architecture/context doc + validation command or test.
  • •Feature work: entrypoint + contract/schema + release/deployment touchpoint.
  • •API changes: route handler + shared types/schema + at least one caller.
  • •Data format changes: proto or migration + serializer/parser + user/dev doc impact.

Fast Lookup Commands

bash
rg -n "keyword" apps crates docs
rg --files docs/dev docs/user
rg -n "route.ts|GET\\(|POST\\(" apps/web/app/api
rg -n "proto|manifest|pack|channel|build" crates apps

References