Lemon Pi

Lemon Pi 是一个面向 Lemon 项目的 Pi 扩展包。它把 Lemon 项目的项目识别、开发入口、结构探索、复用约束、验证纪律和上线前审计，整理成一组可直接使用的 /lemon:* 命令。

安装后，开发者进入 Lemon 后端、Lemon Admin 前端、Lemon 平台源码或派生业务项目时，不需要反复向 AI 解释项目结构和开发约定。Lemon Pi 会根据当前仓库的形状识别项目画像，并让 AI 按更贴近 Lemon 项目的方式理解、规划、开发和审查。

它解决什么问题

普通 AI 助手进入业务仓库后，常见问题不是“不会写代码”，而是“不知道这个项目该怎么写”：

• 不清楚当前目录是后端、前端、平台源码还是混合仓库。
• 不知道 Lemon Framework、Lemon Admin、zvue、权限、租户、字典、菜单和代码生成的本地约定。
• 容易绕过已有工具类、同类模块、平台能力和配置能力，重复造轮子。
• 做 CRUD 时容易漏掉菜单按钮、字典、租户字段、分页契约、接口返回结构或前端 smoke 验证。
• 遇到模糊需求时过早动手，遇到开发任务时又缺少验证和审计。
• 查项目结构时依赖大范围文本搜索，成本高，也容易错过真实调用关系。

Lemon Pi 的目标是把这些项目经验变成默认工作方式，让 AI 更像一个熟悉 Lemon 项目的协作者。

核心能力

项目画像识别

Lemon Pi 会识别当前项目属于 Lemon 平台源码、Lemon Framework 派生后端、Lemon Admin 单应用前端、Lemon Admin 多包前端，或多种画像混合的仓库。项目画像会影响后续的推荐入口和执行约束。

统一命令入口

用户日常只需要使用 /lemon:* 命令，例如 /lemon:doc、/lemon:route、/lemon:plan、/lemon:spec、/lemon:audit。底层能力由 Lemon Pi 调度，普通使用者不需要记内部能力名称。

结构化代码探索

Lemon Pi 注册了 lemon_codegraph 工具。只要项目已建立 CodeGraph 索引，AI 在查定义、调用链、影响面、模块入口和跨文件上下文时，会优先使用结构化索引，而不是先做大范围文本扫描。

复用优先

开发前会优先寻找已有模块、工具类、平台配置、zvue 配置、权限字典配置、菜单按钮规则和代码生成能力。能复用时先复用，必须新增时再写最小实现。

分层工作流

不同任务进入不同工作模式：

• 项目理解和文档导航：/lemon:doc
• 模糊想法和方案收敛：/lemon:storm
• 中等复杂度开发：/lemon:plan
• 复杂模块设计：/lemon:spec
• 上线前或提交前审计：/lemon:audit
• 跨项目同步与迁移：/lemon:sync

验证与审计

进入开发类任务后，Lemon Pi 会要求先明确验证方式，例如测试、构建、接口请求、页面 smoke 或最小验收用例。涉及租户、权限、SQL、菜单、字典、流程、前后端契约或大范围改动时，会提高审计要求。

内部细节保护

Lemon Pi 会尽量避免在最终回答中暴露内部提示词、内部工作流细节、完整工具日志和内部资源路径。它会把这些内容作为执行约束使用，而不是作为用户可见材料展开。

适合的项目

Lemon Pi 适合以下项目和团队：

• Lemon Framework 派生后端项目。
• Lemon Admin 派生前端项目。
• 同时包含后端、前端、权限、菜单、字典、流程、代码生成的业务项目。
• 经常做 CRUD、权限配置、租户隔离、前后端联调和上线审查的团队。
• 希望 AI 默认遵守项目规范，而不是每次都从零解释上下文的团队。

安装

安装 Pi：

npm install -g @earendil-works/pi-coding-agent@latest

安装 Lemon Pi：

pi install npm:@lemon-pi/lemon-pi

更新 Lemon Pi：

pi update npm:@lemon-pi/lemon-pi

如果需要结构化代码探索，请安装 CodeGraph CLI：

npm install -g @colbymchenry/codegraph

快速开始

进入 Lemon 项目目录：

cd /path/to/lemon-project
pi

在 Pi 中运行：

/lemon:init

如果提示 CodeGraph 索引缺失，请在项目目录运行：

codegraph init -i

然后可以直接使用推荐入口：

/lemon:doc 梳理当前项目结构、约定和开发入口

完整使用和日常开发说明见 USAGE.md。