Skill v1.0.1
currentAutomated scan88/100+9 new
version: "1.0.1" name: repo-intake description: "Project initialization inventory (one-time). Use when: first onboarding a project, rebuilding cache after structural changes. Not for: day-to-day development (read cache directly), finding specific files (use code-explore). Output: project map with entrypoints + test map + next steps." allowed-tools: Bash(git:), Bash(node:), Read, Write, Grep, Glob context: fork agent: Explore disable-model-invocation: true
Repo Intake
When to Use
- First time onboarding a project
- Rebuilding cache after major project structural changes
- Cache expired, needs updating
When NOT to Use
- Already familiar with project structure (read cache directly)
- Only need to find specific files (use Glob/Grep)
- Day-to-day development (cache already exists)
Workflow
Docs -> Entrypoints -> Tests Map -> Next Steps
Usage
bash scripts/run-skill.sh repo-intake intake_cached.js --mode auto --top 10
Manifest Map(宣告依賴地圖)
Monorepo / multi-package repo 的 workspace 拓撲與宣告依賴圖。邊語義是 declares_dependency——manifest 裡寫了什麼,不證明 import、呼叫或 runtime 影響。 一律 fail-closed:整份檔案無法讀取/UTF-8 解碼、或 JSON document 無法解析則記 coverage skipped;已進入 Go/TOML recognizer 的相關不支援 construct 則記 partial。絕不產生猜測邊。
bash scripts/run-skill.sh repo-intake manifest_map.js # overview (md)bash scripts/run-skill.sh repo-intake manifest_map.js --format json # 完整 envelopebash scripts/run-skill.sh repo-intake manifest_map.js --reverse <selector> # 誰宣告依賴它bash scripts/run-skill.sh repo-intake manifest_map.js --cycles # 宣告環偵測
| Flag | 說明 | ||
|---|---|---|---|
| `--format md\ | json` | 預設 md;json 為完整 artifact,不受 --top 截斷 | |
--top N | md 清單截斷(預設 12) | ||
--reverse <sel> | selector:節點 ID(ws:node:packages/a)或名稱(node:lodash / lodash);多重匹配 exit 2 並列出候選 | ||
--cycles | 與 --reverse 互斥 | ||
--include-candidates | 把未經 controller 確認的 candidate workspace 納入架構節點集(預設排除) |
生態系:node / php / go / rust / python(辨識 manifest 見 scripts/config/repo-intake.json 的 manifest_map 段)。無效參數 exit 2。 資料模型、解析矩陣與凍結語法契約:references/manifest-map.md;完整規格: docs/features/repo-intake-manifest-map/2-tech-spec.md。
Cache Location
Cache stored at: ~/.claude/cache/repo-intake/<repoKey>/
| File | Description | |
|---|---|---|
latest.md | Latest scan results | |
latest.json | Latest scan results (JSON) | |
LATEST.json | Cache metadata |
Output
## Overview<summary>## Entrypoints-{CONFIG_FILE}-{BOOTSTRAP_FILE}## Test Map| Type | Pattern || ----------- | ----------------- || Unit | test/unit/ || Integration | test/integration/ || E2E | test/e2e/ |## Next Steps-<questions>
Verification
- Output includes Overview, Entrypoints, Test Map, Next Steps
- Entrypoints correctly identify
{CONFIG_FILE},{BOOTSTRAP_FILE} - Test Map covers Unit/Integration/E2E layers
References
references/manifest-map.md— Manifest map 資料模型、解析矩陣、凍結契約摘要references/archived/MIDWAY_HEURISTICS.md— Legacy MidwayJS heuristics (archived, for reference only)
Scripts
| Script | Purpose | |
|---|---|---|
scripts/intake_cached.js | Main intake with caching | |
scripts/scan_repo.js | Full repo scanner (framework-agnostic) | |
scripts/scan_delta.js | Delta scan for changed files | |
scripts/manifest_map.js | Workspace 拓撲 + 宣告依賴圖(overview / reverse / cycles) |
Examples
Input: /repo-intakeAction: Execute intake script -> Output project map
Input: /repo-intake saveAction: Execute intake script -> Output and write to docs/ai/intake/