add-project

/add-project — 添加项目到 vault（含代码分析）

用法：/add-project <项目名> <代码仓库路径>

例如：/add-project ai-agents ~/code/ai-agents

这是新建项目时唯一需要调的命令。Vault 不存在会自动初始化，代码结构会自动分析生成架构草稿。

执行流程

1. 解析参数

• 项目名：用户传的第一个参数。没传则 AskUserQuestion
• 代码路径：用户传的第二个参数。没传则 AskUserQuestion，给出常见候选：
  • ~/code/<项目名> / ~/go/src/<项目名> / ~/projects/<项目名> / 自定义

校验：

• 项目名不能含 / 或空格
• 代码路径必须存在且是目录（[ -d "$path" ]）

2. 检测 vault，不存在则 inline 初始化

VAULT_PATH="${OBSIDIAN_VAULT_PATH:-}"

情况 A：vault 路径已配置且存在 → 直接继续

情况 B：vault 路径未配置 / 不存在 → 用 AskUserQuestion 问：

未找到 Obsidian vault。选择：
  [1] 指定 vault 路径（已有 vault）
  [2] 新建 vault（我会帮你初始化基础结构）
  [3] 取消

选 2 时：直接执行 /init-vault 的全部流程（步骤 1-7），然后继续当前流程。用户无需退出重来。

3. 找到 skill 模板

SKILL_DIR="$HOME/.claude/skills/claude-obsidian-multi-repo-tracker"
TEMPLATE_DIR="$SKILL_DIR/templates/project"

4. 检查目标项目目录

PROJECT_DIR="$VAULT_PATH/项目/<项目名>"

• 已存在 → AskUserQuestion：覆盖 / 换名字 / 取消
• 不存在 → 创建

5. 复制项目模板

复制 templates/project/ 到 <vault>/项目/<项目名>/： 概览.md / activeContext.md / progress.md / 01-架构 ~ 05-测试与调试 各目录

6. 检测语言和依赖

# 语言检测（优先级顺序）
[ -f go.mod ]           → Go，读 go.mod require 取主要依赖
[ -f package.json ]     → Node.js/TypeScript，读 dependencies
[ -f pyproject.toml ]   → Python，读 [tool.poetry.dependencies] 或 [project]
[ -f requirements.txt ] → Python，读前 5 行
[ -f Cargo.toml ]       → Rust，读 [dependencies]
都没有                  → "TODO: 待填写"

7. 扫描代码结构，生成架构草稿

目标：自动填充 概览.md 的"架构速览"和"关键模块"，让用户拿到手就有内容可改，而不是空白占位符。

7a. 扫目录树

find "$CODE_ROOT" -maxdepth 3 -type d \
  ! -path "*/.*" \
  ! -path "*/node_modules/*" \
  ! -path "*/__pycache__/*" \
  ! -path "*/vendor/*" \
  | sort

7b. 按语言识别关键模块

Go：

# 识别有意义的包目录（含 .go 文件）
find "$CODE_ROOT" -maxdepth 3 -name "*.go" | xargs dirname | sort -u
# 读每个主目录下第一个 .go 文件的 package 注释

重点看：cmd/ biz/ pkg/ internal/ api/ service/ handler/

Python：

# 找主文件
ls "$CODE_ROOT"/*.py 2>/dev/null
# 找子包
find "$CODE_ROOT" -name "__init__.py" -maxdepth 3 | xargs dirname

重点看：app.py main.py server.py cli.py