| name | seeed-cli-onboard-skill |
| description | 新项目上手分析。在对陌生项目做任何代码修改前，先用 seeed-cli 完成架构分析、AI 协作文档生成、安全/质量扫描，确保有充分上下文再动手。触发：新项目、陌生代码库、项目分析、架构理解。 |
/seeed-cli-onboard — 新项目分析后修改
新接触一个项目时，禁止直接改代码。必须先用 seeed-cli 完成分析，建立全局理解。
触发条件（按优先级判定）
- 用户显式请求：用户说"分析项目""先了解一下这个项目""新项目上手"等
- 首次进入项目：当前项目根目录不存在
seeed-cli/ 目录，或 seeed-cli/ 下无任何 .md 分析产物
- 产物过期：
seeed-cli/ 下最新 .md 文件的日期早于最近一次 git commit 的日期超过 7 天
工作流程
Step 1: 检查 seeed-cli 是否就绪
seeed-cli -h
检查 API Key：
seeed-cli get-ak BaiLian && seeed-cli get-ak DeepSeek && seeed-cli get-ak GPT
至少一个 provider 有 key 即可。若全部为空，提示用户执行 seeed-cli set-ak <provider> <key> 后停止。
Step 2: 架构分析 (必做)
SEEED_PLAIN=1 seeed-cli frame
等待产物 seeed-cli/frame-*.md 出现后读取。
Step 3: AI 协作文档 (必做)
SEEED_PLAIN=1 seeed-cli gen-ai-agent
等待产物 AI-AGENT.md 更新后读取。
Step 4: 安全/质量扫描 (按需)
若用户目标是修改代码（非纯调研），追加执行：
SEEED_PLAIN=1 seeed-cli safe-scan
SEEED_PLAIN=1 seeed-cli quality
等待 seeed-cli/scan-safe-*.md 和 seeed-cli/scan-quality-*.md 出现后读取。
Step 5: 确定后再修改
读完所有产物后才能改代码，修改时遵守 AI-AGENT.md 约束。
执行策略
并行化
Step 2 + Step 3 可同时启动（互不依赖），Step 4 的两条命令也可同时启动。所有命令均用后台进程执行。
环境变量 SEEED_PLAIN=1
所有 seeed-cli 命令必须加 SEEED_PLAIN=1 前缀。
seeed-cli 默认启动 bubbletea TUI，在非交互式终端（agent 环境/CI）下 TUI 会卡死等待按键退出。设置 SEEED_PLAIN=1 强制跳过 TUI，直接执行工作逻辑并落盘 .md 文件。
| 命令 | 产物路径 | 等多久 |
|---|
SEEED_PLAIN=1 seeed-cli frame | seeed-cli/frame-YYYY-MM-DD_HH_MM_SS.md | 1-3 分钟 |
SEEED_PLAIN=1 seeed-cli gen-ai-agent | ./AI-AGENT.md | 2-5 分钟 |
SEEED_PLAIN=1 seeed-cli safe-scan | seeed-cli/scan-safe-*.md | 2-5 分钟 |
SEEED_PLAIN=1 seeed-cli quality | seeed-cli/scan-quality-*.md | 2-5 分钟 |
产物完成的判定
唯一依据是目标 .md 文件是否已出现，不要解析终端输出（plain 模式下终端无输出）。
- 用
Glob 检查目标产物是否在 seeed-cli/ 目录下出现
- 每 30-60 秒 Glob 一次，LLM 调用慢时需耐心等待，最多等 5 分钟
- 一旦 Glob 返回目标文件，立即
Read 读取
- 同类产物（如 frame-*.md）有多个时，读日期最新的
跳过的判定
若 Glob 发现产物已存在（同日生成），跳过对应命令，直接读已有文件。
读完后做的事
将核心发现写入项目记忆 (memory/)，更新 MEMORY.md 索引：
project_overview.md — 技术栈 + 架构 + 目录结构ai_collaboration_rules.md — AI-AGENT.md 约束摘要security_issues.md — 安全扫描结果quality_issues.md — 质量评审结果
快速模式
只做调研不改代码时，执行 Step 1 + Step 2 + Step 3 即可（生成 AI-AGENT.md 对后续协作有价值）。
冷知识
- 所有分析产物在
seeed-cli/ 目录下
frame 报告可以在 IDE 中直接预览 Mermaid 图gen-ai-agent 生成的 AI-AGENT.md 会被 Claude Code 自动加载为上下文约束- 可以用
s 简写代替 seeed-cli（需先 seeed-cli install-s）
参考
See references/seeed-cli-commands.md for full command reference.
