Menu
最小可行性方案 — 基于已完成的全项目分析（repo-decompose + knowledge-graph + semantic-rag），设定最严格的最小边界条件，剪裁出刚好能跑的核心路径。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
上下文园艺师 — 先读项目，再读 CLAUDE.md，逐层审计四层架构（CLAUDE.md → skills/ → hooks/ → memory/）。不做代码修改，只做审查、总结、归纳。生成建议报告，可视化花园输出。
将 repo-decompose 需求树 + mvp-approach 核心路径转化为分阶段可执行的交付计划。每个 Phase 有明确目标、任务清单、验收标准和依赖关系。
代码优化循环总控 — 12 阶段生命周期（2 前置门控 Detect+EnvReady，10 阶段优化闭环 Observe→Understand→Diagnose→Plan→Bound→Fix→Verify→SelfReview→Learn→Decide）。跨 Agent 自适应，环境自动就绪，任务驱动单流程。
基于 knowledge-graph 模块依赖 + mvp-approach 边界条件 + task-graph 任务清单，生成可修改文件白名单和禁止触碰红区。防止 Agent 无意中修改核心模块。
代码知识图谱 — 四层递进分析（符号表→调用链→数据流→模块依赖），产出完整结构化 Markdown 技术文档供 Loop Agent 和开发者阅读。每个文件有详细分析、每段关键代码有决策解释、模块间有影响矩阵。
循环日志管理 — 每个阶段产出结构化 markdown 日志，记录完整分析过程，可追溯、可检索。自动保存到 .loop-log/，支持按阶段/日期/关键词检索。
Based on SOC occupation classification
| name | mvp-approach |
| description | 最小可行性方案 — 基于已完成的全项目分析（repo-decompose + knowledge-graph + semantic-rag），设定最严格的最小边界条件，剪裁出刚好能跑的核心路径。 |
| argument-hint | mvp approach for [project] | draw the boundary | what's the smallest runnable path |
| dependencies | {"upstream":["repo-decompose","knowledge-graph","semantic-rag"],"downstream":[]} |
本 skill 不从头分析项目。 它在前置 skill 已经跑通全项目分析之后才介入。此时 agent 脑中已经拥有：
repo-decompose 产出的三层需求树（架构需求 / 数据需求 / 逻辑需求）knowledge-graph 产出的符号调用链 + 数据流 + 模块依赖图semantic-rag 产出的项目语义方向 + 多语言解释 + RAG 索引在这些完整信息的支撑下，mvp-approach 只做一件事：
设定最严格的最小边界条件，从需求树中剪裁出恰好能让项目跑起来的那条核心路径。
核心原则：不是"从零开始想怎么做"，而是"已经知道了全部，现在砍掉一切非必需的"。
本 skill 是流水线终点。上游输出缺失时，必须拒绝执行并告知用户缺少什么。
门控检查（按顺序，第一个失败即 STOP）:
[1] .repo-decompose-context.json 存在？
NO → STOP. 输出: "❌ 缺少 repo-decompose 的输出。请先运行 /decompose <repo-url>"
[2] architecture.status == "done"？
NO → STOP. 输出: "❌ 架构层分析未完成。请等待 repo-decompose Phase 1 完成"
[3] data.status == "done" && logic.status == "done"？
NO → STOP. 输出: "❌ 数据层/逻辑层分析未完成。请等待 repo-decompose Phase 2 完成"
[4] merge == "done"？
NO → STOP. 输出: "❌ 需求树未合并。repo-decompose Phase 3 仍在进行"
[5] supplements.knowledgeGraph != null？
NO → STOP. 输出: "❌ 缺少 knowledge-graph 分析。请运行 /graph <repo-path>"
[6] supplements.semanticRAG != null？
NO → STOP. 输出: "❌ 缺少 semantic-rag 分析。请运行 /explain <repo-path>"
所有 6 项通过 → 进入 Step 1
决不允许的行为：
基于 semantic-rag 的项目语义概览，回答一个问题：
这个项目的"唯一正确方向"是什么？
这不是开放式提问。是从已有分析中提炼，而不是重新猜测。
输入: semantic-rag 项目身份卡 + 语义概览
输出: 一句话方向声明
示例:
身份卡: "Next.js 全栈 Web 应用, App Router, 提供代码仓库可视化分析"
方向声明: "让开发者在浏览器中输入 GitHub URL，30 秒内获得项目架构全景图"
反模式：
自检： 方向声明能不能用 15 个字以内说出来？不能 → 继续收束。
把 repo-decompose 的需求树拿过来，逐项标注：
标注规则:
🔴 核心路径 — 删掉它，方向声明中的动作就无法演示
🟡 支撑路径 — 核心路径需要它，但它不直接可见
✂️ 可砍 — 删掉它，核心动作仍然能演示
标注过程不需要重新分析需求——需求树已经由 repo-decompose 的各层子 Agent 并行分析产出。本步骤只做判定。
示例 (基于 "GitHub URL → 架构全景图" 方向):
📦 repo-visualizer
├── 🏗️ 架构需求
│ ├── 🔴 REQ-A1: URL 解析模块
│ ├── 🟡 REQ-A2: Git 浅克隆模块
│ └── ✂️ REQ-A3: 多仓库对比功能
├── 🗄️ 数据需求
│ ├── 🔴 REQ-D1: 文件树数据结构
│ ├── ✂️ REQ-D2: 历史版本存储
│ └── ✂️ REQ-D3: 用户偏好持久化
└── 🧠 逻辑需求
├── 🔴 REQ-L1: 项目类型识别 (Node/Python/Go)
├── 🔴 REQ-L2: 架构图生成器
├── 🟡 REQ-L3: 依赖关系解析
└── ✂️ REQ-L4: 代码质量评分
判定辅助（来自前置数据）：
| 判断依据 | 来源 skill | 用法 |
|---|---|---|
| 这个模块被核心路径调用了吗？ | knowledge-graph 调用链 | 不在调用链上 → ✂️ |
| 这个数据是核心动作的输入/输出吗？ | knowledge-graph 数据流 | 不在数据流上 → ✂️ |
| 这个模块在语义概览中被提及了吗？ | semantic-rag 语义概览 | 没提及 → 大概率 ✂️ |
出口标准： 所有 REQ 都被标注为 🔴 / 🟡 / ✂️，且 🔴 的数量 ≤ 🟡 + ✂️ 的数量（核心路径应该是最窄的）。
核心路径已标出。现在设定硬边界——超过即停止。
边界不是拍脑袋的数字。 根据 semantic-rag 识别的项目类型，按以下分层标准设定：
项目类型检测（来自 semantic-rag 项目身份卡）:
┌────────────────────┬──────────┬──────────┬──────────┬──────────────────────────┐
│ 项目类型 │ 代码上限 │ 文件上限 │ 依赖上限 │ 典型项目 │
├────────────────────┼──────────┼──────────┼──────────┼──────────────────────────┤
│ 脚本/工具 │ ≤200 行 │ ≤3 文件 │ 0 │ 单文件 CLI、Shell 工具 │
│ Web API/服务 │ ≤500 行 │ ≤5 文件 │ ≤2 │ Express/FastAPI 端点 │
│ CLI/MCP 工具 │ ≤800 行 │ ≤8 文件 │ ≤3 │ MCP server、dev 工具链 │
│ 系统软件/DB/编译器 │ 1000-1500│ ≤12 文件 │ ≤5 │ SQLite store、LSP、编译器 │
│ │ (骨架版) │ │ │ │
└────────────────────┴──────────┴──────────┴──────────┴──────────────────────────┘
共同硬边界:
□ 配置项上限: 0 (全部硬编码)
□ 抽象层上限: 0 (无 interface / abstract class / factory)
□ 步骤数上限: 核心路径 🔴 数量 (每个 🔴 → 一个实现步骤)
为什么不能一刀切 200 行： 对 Web demo 或小脚本，200 行是合理的。但对 MCP server、SQLite store、LSP 这类系统软件，200 行很可能连骨架都搭不起来——agent 会为了满足边界而产出假的 MVP（跳过必要的初始化/错误处理/资源释放）。分层之后，每个类型有自己合理的"最小"定义。
为什么边界要按项目类型分层： Agent 知道整个项目的全貌（来自前置 skill），也知道了项目类型（来自 semantic-rag 身份卡）。同样的"核心路径"在不同类型的项目里，实现代价完全不同——一个编译器的"核心路径"天然比一个脚本大 5-10 倍。分层边界确保 Agent 不会为了凑数字而省略骨架代码。
从核心动作的终点倒推实现步骤。每步一个可验证产物：
格式:
Step N (最终): [核心动作的用户可见结果]
→ 验证: [用户看到什么]
→ 依赖: [需要 Step N-1 提供什么]
Step N-1: [让 Step N 能跑的最近依赖]
→ 验证: [用户/终端看到什么]
... (倒推到入口)
Step 1: [用户触发/输入]
→ 验证: [用户看到什么]
倒推规则：
出口： 一份带验证点的倒推实现清单，步骤数不超过边界上限。
🎯 方向声明: [来自 Step 1]
📋 最小实现路径:
Step 1: [动作] → 验证: [可见结果]
Step 2: [动作] → 验证: [可见结果]
...
🔒 边界条件:
文件数 ≤ N | 行数 ≤ M | 依赖数 ≤ D | 步骤数 ≤ S
✂️ 已剪裁:
[需求ID] — [一句话理由]
...
📊 来源:
需求树: repo-decompose
符号关系: knowledge-graph
语义方向: semantic-rag
方案写完了不等于能跑。 本 step 的五级验证链（L1 build → L2 --help → L3 command → L4 artifact → L5 content）已独立为 verification-loop skill。
verification-loop。engineering-loop 的 Verify 阶段自动调用。快速验证（独立模式）:
Level 1 — build: [自动提取编译命令] → 必须 PASS
Level 3 — command: [核心动作的最简命令] → 必须 exit 0 + 有输出
如果验证失败： 回到 Step 4，重新评估最小路径是否真的最小。
最终方案中追加：
🔬 运行验证:
L1 build: [命令] → [结果]
L3 run: [命令] → [结果]
| # | Agent 借口 | 为什么在这个阶段不成立 |
|---|---|---|
| 1 | "knowledge-graph 显示这个模块被很多地方依赖，应该保留" | 被依赖 ≠ 核心路径需要。高扇入模块不在 🔴 路径上 → 仍砍 |
| 2 | "semantic-rag 提到这个模块是'重要的'" | "重要"是语义判断，不是核心路径判断。只认 🔴 |
| 3 | "这个 REQ 标注 🟡 但其实很容易一起做掉" | "容易"不是保留的理由。✂️ 就是 ✂️ |
| 4 | "边界条件太严格了，稍微放宽一点" | 边界是先算出来的，不是猜的。不谈判 |
| 5 | "repo-decompose 的架构层提到了这个，应该做" | 架构分析是全面分析，mvp 只取核心路径 |