القائمة
Use .ai-code-index for local search, symbols, profiles, files, stats, refresh, and diagnostics.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | arc:code-index |
| description | Use .ai-code-index for local search, symbols, profiles, files, stats, refresh, and diagnostics. |
Use this skill when a repository has, needs, or should maintain a project-local .ai-code-index/ toolchain. The index is local only and is optimized for AI agents that need faster, broader code discovery than repeated whole-repo rg.
Default behavior: search the local index first, then use symbol and structural tools, then use profile-aware file discovery. Use rg only for small confirmation, unindexed generated trees, protected/reference trees, or index fallback.
.ai-code-index, code search coverage, stale indexes, local search workflow, symbol lookup, structural search, file discovery, or code inventory..ai-code-index/search.sh, symbols.sh, files.sh, struct-search.sh, or stats.sh before broad rg, and runs doctor.sh when results look incomplete.arc:build, arc:fix, or arc:audit for the implementation, repair, or review that follows.Project root layout:
.ai-code-index/
├── README.md
├── lib.sh
├── manifest.yaml
├── reindex.sh
├── search.sh
├── symbols.sh
├── struct-search.sh
├── files.sh
├── stats.sh
├── install-tools.sh
├── doctor.sh
├── repository-map.md
├── index/ # generated Zoekt shards, gitignored
├── tags # generated ctags symbols, gitignored
├── .last-profile # generated profile marker, gitignored
├── .last-indexed-at # generated freshness marker, gitignored
└── .reindex.lock/ # transient refresh lock, gitignored
Core responsibilities:
lib.sh: shared paths, profiles, ignore rules, file helpers, auto-refresh checks, and query filters.reindex.sh: rebuild Zoekt shards and Universal Ctags symbols; write .last-profile and .last-indexed-at.search.sh: run Zoekt search with profile filters and auto-refresh.symbols.sh: query ctags symbols with optional profile, language, and kind filters; auto-refresh when needed.struct-search.sh: run ast-grep (sg) for AST patterns.files.sh: profile-aware file discovery; prefer Rust fd / fdfind, fall back to find.stats.sh: profile-aware code inventory; prefer Go scc, then Rust tokei, then a minimal shell fallback.install-tools.sh: install recommended Rust/Go helper CLIs through Homebrew where appropriate.doctor.sh: diagnose tools, paths, stale shards, profile coverage, and smoke queries.repository-map.md: human-readable map of profile scopes and important roots.Use profiles to keep search broad enough for context but narrow enough to avoid noise.
| profile | intended contents |
|---|---|
code | default active code surfaces plus light docs and meta files |
backend | backend service code |
pc | active PC reader, author, and admin frontends |
android | active Android app source |
docs | stable requirements/API docs, excluding task dumps and profiler output |
docs-full | complete docs tree |
meta | root docs/config, scripts, AGENTS.md, and .ai-code-index docs/scripts |
all | code plus complete docs, still using ignore rules |
ref | reference projects or vendor sources, on demand only |
For a new repository, define the actual paths in lib.sh. Do not assume these profile names map to the same directories across projects.
.ai-code-index/doctor.sh --profile <profile> when the index is new, stale, suspicious, or recently migrated..ai-code-index/search.sh --profile <profile> "<query>" for broad intent, strings, routes, config keys, and call-site discovery..ai-code-index/symbols.sh <Name> --profile <profile> [--lang <lang>] [--kind <kind>] for definitions and symbol inventories..ai-code-index/files.sh --profile <profile> [--ext <ext>] "<path-or-name-hint>" to locate candidate files before opening many paths..ai-code-index/struct-search.sh <lang> '<ast-pattern>' [paths...] before refactors or when finding code shapes..ai-code-index/stats.sh --profile <profile> [--json] before broad audits, ownership reviews, or migration sizing..ai-code-index/reindex.sh --profile <profile> after changing profile paths, ignore rules, generated docs, or major file layouts.rg only for small confirmations, generated files, protected/reference trees, or cases where the index explicitly cannot cover the target..ai-code-index/doctor.sh --profile code
.ai-code-index/reindex.sh --profile code
.ai-code-index/search.sh --profile backend "RecordReadingProgress file:go"
.ai-code-index/symbols.sh RecordReadingProgress --lang go --profile backend
.ai-code-index/struct-search.sh go 'func (s *Service) RecordReadingProgress($$$) ($$$) { $$$ }' backend/internal/usecase/novel/service.go
.ai-code-index/files.sh --profile backend --ext go 'controller'
.ai-code-index/stats.sh --profile code
.ai-code-index/install-tools.sh --dry-run
AI_CODE_INDEX_AUTO_REINDEX=0 .ai-code-index/search.sh --profile code "frozen query"
Core tools:
zoekt / zoekt-index: local full-text and regex search.sg from ast-grep: structural search.Preferred helper CLIs are Rust or Go tools:
fd / fdfind, tokei, jaq, sdscc, yq, daselDo not add new Python or TypeScript CLI dependencies to the code-index workflow. Existing repository validation scripts may still use the repository's own language stack; this rule is for .ai-code-index helper tooling.
search.sh and symbols.sh should refresh automatically when:
.last-indexed-at;.ai-code-index scripts or AGENTS instructions changed;Disable auto-refresh only for intentionally frozen comparisons:
AI_CODE_INDEX_AUTO_REINDEX=0 .ai-code-index/search.sh --profile code "query"
.ai-code-index/README.md describing profiles, generated files, refresh, and agent search order.doctor.sh --profile code reports missing tools, missing paths, stale indexes, and smoke-query failures clearly.reindex.sh is idempotent and safe to rerun.search.sh and symbols.sh either return current results or fail loudly with refresh/tool guidance.rg because the index could not cover the target.rg repeatedly while .ai-code-index/search.sh is present and healthy.ctags is not Universal Ctags or symbol lookup silently returns partial results.doctor.sh is missing, stale, or does not perform smoke queries..ai-code-index/index/, .ai-code-index/tags, or freshness markers are committed..ai-code-index, local code search, index coverage, stale search results, symbol lookup, ast-grep, Zoekt, ctags, profile search, code inventory, or replacing repeated rg.| parameter | type | required | description |
|---|---|---|---|
project_path | string | yes | Repository root containing or needing .ai-code-index/ |
profile | string | no | Search scope such as code, backend, pc, android, docs, all, or project-specific profile |
query | string | no | Text, regex, symbol, route, config key, or intent to search |
language | string | no | Language for structural or symbol search |
pattern | string | no | ast-grep pattern when structural search is needed |
freshness | string | no | Concern such as missing results, stale paths, changed layout, or old profile |
Code Index Handoff
- Profile used
- Commands run or recommended
- Search/symbol/file/stat findings
- Refresh or doctor result
- Missing Rust/Go helper tools
- Stale path or coverage risks
- Reason for any rg fallback
Read-only project/AppSec audit: assets, data map, vuln review; Lark risks via arc:docs.
Local SAST/SCA/secrets/DAST automation with data-value re-ranking and Arc handoffs.
Current-state task docs; security/audit handoff to detailed subtasks with roles and caliber.
Apply backend architecture, DIP, usecase result boundaries, zap logging, Go constants, and helper limits.
Add low-cost fmt/time or log.Printf timing probes to Go Gin SSR request paths.
Apply Chinese comment conventions; avoid noisy parameter/return boilerplate on obvious usecase contracts.