proxycast/docs/aiprompts

docs/aiprompts 索引

本目录存放 Lime 仓库的模块级说明、工程流程和治理文档。 根 AGENTS.md 只保留仓库级规则；超过“规则/入口”粒度的说明统一放到这里。

使用原则

1. 先按场景找入口 - 不确定从哪里开始时，优先读本页
2. 先读对应文档再改代码 - 尤其是命令边界、GUI 主路径、迁移收口、Provider 与凭证
3. GUI 改动优先看质量链路 - Lime 是 GUI 桌面产品，先看 quality-workflow.md 与 playwright-e2e.md
4. 新旧并存问题先看治理文档 - 避免在 compat / deprecated 路径上继续长新表面

按场景导航

架构与治理

• overview.md - 项目架构总览与模块分层
• governance.md - 新旧并存治理、迁移收口、禁止回流
• quality-workflow.md - 本地校验、GUI smoke、契约检查、CI 门禁
• skill-standard.md - 统一技能标准、skill / adapter / runtime binding 边界
• site-adapter-standard.md - 站点适配器标准、来源导入边界、运行时收敛规则
• project-heatmap.md - 仓库热力图与治理候选分析
• limecore-collaboration-entry.md - 跨仓库联动入口
• ../tech/harness/README.md - Lime Harness Engineering 总入口与实施蓝图

GUI 与前端

• design-language.md - 全局 UI 视觉语言
• components.md - React 组件约定
• hooks.md - 自定义 Hooks
• lib.md - 前端工具库与运行时封装
• workspace.md - Workspace 边界与工作区模型
• playwright-e2e.md - GUI 续测、Playwright MCP、交互验证
• performance-profiling.md - 性能分析与剖析方法

后端与运行时

• commands.md - Tauri 命令边界、协议同步点
• services.md - Rust 服务层
• server.md - HTTP Server 与接口边界
• mcp.md - MCP 服务器与工具管理
• terminal.md - 内置终端与 PTY
• plugins.md - 插件系统
• aster-integration.md - Aster Agent 集成

Provider 与数据

• providers.md - Provider 接入与认证方式
• credential-pool.md - 凭证池、运行时路径、调试入口
• converter.md - 协议转换与兼容层
• database.md - 数据库层与持久化

常见入口建议

• 改 UI / 页面结构：先读 design-language.md，再看 quality-workflow.md
• 改 Tauri 命令 / Bridge / mock：先读 commands.md，再看 quality-workflow.md
• 改 Claw 技能 / Service Skill / 统一 Skills 标准：先读 skill-standard.md
• 改站点适配器 / 导入外部 adapter：先读 site-adapter-standard.md，再看 quality-workflow.md
• 改 Workspace / GUI 壳 / 主路径：先读 workspace.md、quality-workflow.md、playwright-e2e.md
• 做迁移 / 收口 / 去兼容层：先读 governance.md
• 改 Provider / 凭证加载 / Token 刷新：先读 providers.md、credential-pool.md
• 做跨仓库联动：先读 limecore-collaboration-entry.md

对应 Codex Skills

• 治理收口：.codex/skills/lime-governance/
• GUI 设计语言：.codex/skills/lime-design-language/
• 工程质量 / 交付判断：.codex/skills/lime-quality-workflow/
• 命令边界 / 契约同步：.codex/skills/lime-command-boundary/
• GUI 续测 / Playwright MCP：.codex/skills/lime-playwright-e2e/
• 热力图 / 治理优先级：.codex/skills/lime-project-heatmap/
• 项目技能提炼：.codex/skills/project-skill-factory/

维护规则

1. 新增长期文档后，要同步更新本索引
2. 根 AGENTS.md 不再堆叠长流程，统一链接到这里
3. 如果某段说明已经变成长期流程或模块说明，应从根规则迁到本目录
4. 如果某条工作流已经高频复用到值得做成 skill，同步检查 .codex/skills/README.md