@lemon-pi/lemon-pi
Lemon Pi
Lemon Pi 是面向 Lemon 项目的 AI 开发助手增强包。
它让 Pi 在进入 Lemon 平台、Lemon Admin、Lemon Framework 或派生业务项目时，默认懂项目画像、开发约定、权限菜单、租户边界、前后端协作和上线前检查。你不需要每次从零解释项目结构，也不需要记一堆底层能力名；日常只用 /lemon:* 命令描述需求即可。
为什么需要它
普通 AI 助手进入一个 Lemon 项目，常见问题是：
- 不知道当前仓库是后端、前端、平台源码，还是前后端混合项目。
- 容易绕过现有模块、工具类、代码生成器和页面约定，重复造轮子。
- 不熟悉 Lemon 的返回结构、分页、逻辑删除、租户、数据权限、菜单、按钮和字典规则。
- 做前后端功能时，容易漏掉接口契约、权限 SQL、菜单入口和页面验证。
- 方案讨论时过早进入写代码，或者开发时没有先定义验证方式。
- 项目结构探索时容易用大量搜索命令乱扫，而不是优先走结构化索引。
Lemon Pi 把这些经验沉淀成默认工作协议，让 AI 更像一个熟悉 Lemon 项目的协作者。
它能带来什么
进入项目先识别
Lemon Pi 会识别当前项目画像，并根据后端、前端、平台源码、派生项目或混合仓库选择不同工作方式。
只暴露简单入口
底层 Lemon 能力被隐藏为内部知识库，用户只需要使用 /lemon:init、/lemon:route、/lemon:plan、/lemon:spec、/lemon:audit 等命令。
优先理解结构
在支持 CodeGraph 的项目中，Lemon Pi 会要求 AI 优先使用结构化索引理解模块、调用链、定义位置和影响面，减少无目的的全仓搜索。
先想清楚再动手
模糊需求会先进入方案探索；中等任务会先规划；复杂模块会先整理需求、设计、任务和验收点。
默认复用已有能力
开发前会优先寻找同模块实现、Lemon Framework 工具类、zvue 配置、权限字典配置、菜单按钮规则和代码生成能力。
开发带验证纪律
真正进入开发任务后，会先明确测试、复现步骤、接口请求、构建检查或验收用例。交付时必须说明验证结果。
高风险自动提醒审计
涉及租户、权限、数据权限、菜单、字典、SQL、前后端契约或大范围改动时，Lemon Pi 会要求进入审计流程。
适合谁
- 维护 Lemon Framework 派生后端的开发者。
- 维护 Lemon Admin 派生前端的开发者。
- 经常做 CRUD、菜单、按钮、字典、租户、流程审批和前后端联调的团队。
- 希望 AI 更懂项目约定，而不是每次都从零解释上下文的人。
- 希望开发过程默认具备复用意识、验证意识和审计意识的团队。
典型用法
第一次进入项目：
/lemon:init不知道用哪个入口：
/lemon:route 给课程分类管理增加后端 CRUD、前端列表、新增、编辑、删除和菜单权限只是了解项目：
/lemon:doc 梳理当前项目结构、约定和开发入口需求还模糊：
/lemon:storm 我想做一个 AI 助教使用率看板，你有什么想法复杂模块：
/lemon:spec 设计课程体系管理模块，包含分类、课程、章节、上下架、权限和审计完整使用说明见 USAGE.md。