| 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
bash scripts/run-skill.sh repo-intake manifest_map.js --format json
bash 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-intake
Action: Execute intake script -> Output project map
Input: /repo-intake save
Action: Execute intake script -> Output and write to docs/ai/intake/
