- Read
gitnexus://repo/{name}/context— codebase overview + check index freshness - Match your task to a skill below and read that skill file
- Follow the skill's workflow and checklist
- Follow config/state file rules:
docs/gitnexus-config-files.md - If user asks to release/publish a specific version and this repo has
DISTRIBUTION.md, execute that workflow in full-release mode by default (unless user explicitly asksprepare-onlyorpublish-only).
If step 1 warns the index is stale, ask user whether to rebuild index via
gitnexus analyzewhen local CLI exists; otherwise resolve the pinned npx package spec from~/.gitnexus/config.json(cliPackageSpecfirst, thencliVersion) and runnpx -y <resolved-spec> analyze(it reuses previous analyze scope/options by default; add--no-reuse-optionsto reset). If user declines, explicitly warn that retrieval may not reflect current codebase. For build/analyze/test commands, use a 10-30 minute timeout; on failure/timeout, report exact tool output and do not auto-retry or silently fall back to glob/grep.query/contextslim guidance is narrowing-first: inspectdecision.recommended_follow_up,missing_proof_targets, andsuggested_context_targetsbefore upgrading toresponse_profile=full.
| Task | Read this skill file |
|---|---|
| Understand architecture / "How does X work?" | .agents/skills/gitnexus/gitnexus-exploring/SKILL.md |
| Blast radius / "What breaks if I change X?" | .agents/skills/gitnexus/gitnexus-impact-analysis/SKILL.md |
| Trace bugs / "Why is X failing?" | .agents/skills/gitnexus/gitnexus-debugging/SKILL.md |
| Rename / extract / split / refactor | .agents/skills/gitnexus/gitnexus-refactoring/SKILL.md |
| Tools, resources, schema reference | .agents/skills/gitnexus/gitnexus-guide/SKILL.md |
| Index, status, clean, wiki CLI commands | .agents/skills/gitnexus/gitnexus-cli/SKILL.md |
- 统一设计与实现对照文档:
docs/unity-runtime-process-source-of-truth.md - 涉及 Unity runtime process 的任务,先阅读该文档,再执行检索/实现/验收。
- 若历史设计文档与当前实现不一致,以该真理源文档和对应代码为准,并在变更后同步更新。