[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-75460":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":13,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":14,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":15,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":16,"fork":16,"defaultBranch":17,"hasWiki":18,"hasPages":16,"topics":19,"createdAt":10,"pushedAt":10,"updatedAt":20,"readmeContent":21,"aiSummary":22,"trendingCount":14,"starSnapshotCount":14,"syncStatus":23,"lastSyncTime":24,"discoverSource":25},75460,"Lotus","Bronc-X\u002FLotus","Bronc-X","Write your AI agent rules once, deploy to every IDE. Global protocol for Claude Code, Cursor, Windsurf, Antigravity, Codex & more.","",null,"Shell",15,1,0,0.9,false,"main",true,[],"2026-06-12 02:03:34","# Lotus\n\nLotus 是一套全局 Agent 工程规则与安装器。它的目标很简单：把你希望 AI 编码助手长期遵守的工作方式，安装到受托管宿主的全局配置中，让新项目自动继承这些规则。\n\nLotus 当前托管两类内容：\n\n1. Lotus 全局规则：写入 Claude Code 与 Codex 的全局规则文件。\n2. 官方 gstack 运行时：从 [garrytan\u002Fgstack](https:\u002F\u002Fgithub.com\u002Fgarrytan\u002Fgstack) 安装并同步默认顶层 skills。\n\nLotus 仓库不再内置 gstack 快照。凡是 gstack 能力，官方上游 `garrytan\u002Fgstack` 是唯一真源。\n\n## 管理范围\n\n| 宿主 | 全局安装命令 | Lotus 写入位置 | 说明 |\n|---|---|---|---|\n| Claude Code | `install.ps1 -Global` \u002F `install.sh --global` | `~\u002F.claude\u002FCLAUDE.md`、`~\u002F.claude\u002Fskills` | 受托管 |\n| Codex CLI \u002F Codex App | `install.ps1 -Global` \u002F `install.sh --global` | `~\u002F.codex\u002FAGENTS.md`、`~\u002F.codex\u002Fskills` | 受托管 |\n\n其他宿主不由 Lotus 安装器自动写入全局路径。如果该宿主支持手动全局规则，请直接导入 [core\u002FAGENTS.md](core\u002FAGENTS.md)。\n\n## Lotus 四条执行护栏\n\n全局规则文件顶部会注入四条最高优先级护栏：\n\n1. Think Before Coding：先确认目标、边界、假设、成功标准，再写代码。\n2. Simplicity First：只写解决当前问题所需的最小代码，不提前抽象。\n3. Surgical Changes：只改和当前目标直接相关的文件、函数和行。\n4. Goal-Driven Execution：把任务改写成可验证目标，再实现并验证。\n\n这些不是提示词装饰，而是每次会话开始时宿主自动读取的全局规则。安装完成后，需要重启宿主或开启新会话，旧会话不会自动获得新的全局规则。\n\n## 零基础快速安装提示词\n\n如果你不熟悉命令行，可以把下面整段提示词复制给你的 AI 编码助手。它应该在你的本地机器执行这些步骤。\n\n```text\n这是一个全新项目目录。请在本地执行以下初始化步骤：\n\n1. 先记录当前项目目录的绝对路径，不要在克隆 Lotus 时丢失这个路径。\n2. 将 https:\u002F\u002Fgithub.com\u002FBronc-X\u002FLotus.git 克隆到系统临时目录中的一个新目录。\n3. 判断当前操作系统。\n4. 在临时 Lotus 仓库中运行项目模板安装，把 nextjs 模板应用到我当前项目目录：\n   - Windows PowerShell: 使用完整路径执行 `install.ps1 -Project nextjs`\n   - macOS\u002FLinux: 使用 `bash install.sh --project nextjs`，不要依赖 `install.sh` 是否有可执行权限\n5. 为了让这台机器以后所有受托管宿主都继承 Lotus 规则，再运行全局安装，并使用非交互确认参数避免卡住：\n   - Windows PowerShell: `install.ps1 -Global -Force`\n   - macOS\u002FLinux: `bash install.sh --global --yes`\n6. 完成后删除刚才克隆的临时 Lotus 仓库。\n7. 仔细阅读当前项目目录中新生成的 AGENTS.md 和 .agents\u002Frules\u002F，确认你理解本项目的编码标准、技术栈约束和设计语言。\n8. 验证全局规则与 skills 已写入宿主目录：\n   - Codex: `~\u002F.codex\u002FAGENTS.md` 和 `~\u002F.codex\u002Fskills`\n   - Claude Code: `~\u002F.claude\u002FCLAUDE.md` 和 `~\u002F.claude\u002Fskills`\n9. 确认至少存在 Lotus 自带 skills（例如 `image-2`、`taste-skill`）和默认 gstack 顶层入口（例如 `gstack`、`gstack-qa` 或 Windows\u002F网络失败时的 bootstrap 入口）。\n10. 告诉我当前宿主是否需要完全重启或开启新会话，才能加载刚写入的全局规则和全局 skills。\n11. 最后告诉我安装是否成功；如果失败，给出失败命令、错误原文、已写入了哪些 fallback\u002Fbootstrap 入口，以及下一步修复建议。\n```\n\n如果项目不是 Next.js，把 `nextjs` 改成 `vite` 或 `html`。\n\n## 手动安装\n\n### 第 0 步：克隆 Lotus\n\n选择一个长期保存 Lotus 的目录。以后更新 Lotus 时就在这里执行 `git pull`。\n\nWindows PowerShell：\n\n```powershell\ngit clone https:\u002F\u002Fgithub.com\u002FBronc-X\u002FLotus.git C:\\Dev\\Lotus\n```\n\nmacOS \u002F Linux：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FBronc-X\u002FLotus.git ~\u002FDev\u002FLotus\n```\n\n### 第 1 步：全局安装\n\nWindows PowerShell：\n\n```powershell\nC:\\Dev\\Lotus\\install.ps1 -Global\n```\n\nmacOS \u002F Linux：\n\n```bash\n~\u002FDev\u002FLotus\u002Finstall.sh --global\n# 如果下载方式丢失了可执行权限，也可以用：\nbash ~\u002FDev\u002FLotus\u002Finstall.sh --global\n```\n\n这一步会：\n\n1. 写入 Claude Code 全局规则：`~\u002F.claude\u002FCLAUDE.md`\n2. 写入 Codex 全局规则：`~\u002F.codex\u002FAGENTS.md`\n3. 安装 Lotus 自带 skills。\n4. 安装或更新官方 gstack 到 `~\u002F.gstack\u002Frepos\u002Fgstack`。\n5. 同步默认顶层 gstack skills 到 `~\u002F.claude\u002Fskills` 和 `~\u002F.codex\u002Fskills`。\n\n如果已存在全局规则文件，安装器会先创建 `.bak` 备份，再覆盖。无人值守安装可以使用：\n\nWindows：\n\n```powershell\nC:\\Dev\\Lotus\\install.ps1 -Global -Force\n```\n\nmacOS \u002F Linux：\n\n```bash\n~\u002FDev\u002FLotus\u002Finstall.sh --global --yes\n```\n\n### 第 2 步：项目模板安装，可选\n\n如果你希望当前项目目录里也出现项目级规则文件，例如 `AGENTS.md` 和 `.agents\u002Frules\u002F`，在项目目录执行：\n\nWindows PowerShell：\n\n```powershell\ncd C:\\Users\\YourName\\Projects\\MyNewApp\nC:\\Dev\\Lotus\\install.ps1 -Project nextjs\n```\n\nmacOS \u002F Linux：\n\n```bash\ncd ~\u002FProjects\u002FMyNewApp\n~\u002FDev\u002FLotus\u002Finstall.sh --project nextjs\n```\n\n可用模板：\n\n- `nextjs`\n- `vite`\n- `html`\n\n全局安装不会在每个项目目录自动生成 `AGENTS.md`。Codex 会自动继承 `~\u002F.codex\u002FAGENTS.md`，Claude Code 会自动继承 `~\u002F.claude\u002FCLAUDE.md`。项目级模板是额外叠加层，只在你主动运行 `-Project` \u002F `--project` 时写入当前项目。\n\n## Windows 依赖说明\n\n官方 gstack 完整运行时依赖：\n\n- `git`\n- `bash`\n- `bun`\n- Windows 下还需要 `node`\n\nWindows 上的 `bash` 通常来自 [Git for Windows](https:\u002F\u002Fgit-scm.com\u002Fdownload\u002Fwin)。\n\n如果机器没有 Git Bash，或官方 gstack runtime 安装失败，`install.ps1 -Global` 仍会安装默认 11 个顶层 gstack bootstrap skills，保证 `\u002Fgstack-*` 菜单入口不缺失。macOS \u002F Linux 的 `install.sh --global` 也会在官方 runtime 下载失败时写入同样的 bootstrap 入口。安装 Git for Windows 并补齐依赖后，重新运行：\n\n```powershell\nC:\\Dev\\Lotus\\install.ps1 -Global\n```\n\n重新运行后，bootstrap 入口会被完整官方 gstack 运行时替换，并恢复官方自动更新能力。\n\n## macOS \u002F Codex App \u002F Claude Code 说明\n\nCodex App、Claude Code 和 IDE 启动的命令行有时不会加载你的 `.zprofile` \u002F `.bashrc`，导致 `bun` 已安装但安装器找不到。Lotus 安装器会自动补充常见工具路径：\n\n- `~\u002F.bun\u002Fbin`\n- `~\u002F.local\u002Fbin`\n- `\u002Fopt\u002Fhomebrew\u002Fbin`\n- `\u002Fusr\u002Flocal\u002Fbin`\n\n官方 gstack 在 macOS 上会尝试用 Homebrew 安装可选的 `coreutils`，只为了给少数命令增加 timeout 保护。Lotus 托管安装默认跳过这个可选步骤，避免全局安装卡在 Homebrew。确实需要该增强时，可以自己安装：\n\n```bash\nbrew install coreutils\n```\n\n如果 GitHub 网络短暂抖动，安装器会重试官方 gstack 下载；本机已经有 `~\u002F.gstack\u002Frepos\u002Fgstack` 时，会优先使用现有 checkout 完成 skills 同步。没有可用 checkout 时，安装器会写入 bootstrap slash skills，等网络恢复后重新运行全局安装即可替换成完整 runtime。\n\n## 默认暴露的 gstack 顶层 skills\n\n默认 `core` profile 会暴露 11 个顶层 gstack skills：\n\n- `gstack`\n- `gstack-office-hours`\n- `gstack-plan-ceo-review`\n- `gstack-plan-design-review`\n- `gstack-plan-eng-review`\n- `gstack-design-review`\n- `gstack-review`\n- `gstack-investigate`\n- `gstack-browse`\n- `gstack-qa`\n- `gstack-ship`\n\n可选 profile：\n\n| Profile | 暴露内容 |\n|---|---|\n| `core` | 默认 11 个顶层 skills |\n| `design` | `core` 加设计相关 skills |\n| `review` | `core` 加 QA \u002F review \u002F health 相关 skills |\n| `deploy` | `core` 加发布部署相关 skills |\n| `full` | 暴露当前官方 gstack 全量顶层 skills |\n\n切换 profile：\n\nWindows：\n\n```powershell\nC:\\Dev\\Lotus\\install.ps1 -Global -GstackProfile design\n```\n\nmacOS \u002F Linux：\n\n```bash\n~\u002FDev\u002FLotus\u002Finstall.sh --global --gstack-profile design\n```\n\n## 安装后验证提示词\n\n全局安装后，请打开一个新的宿主会话，把下面提示词复制给 AI 助手：\n\n```text\n请验证 Lotus 是否已经在当前宿主全局生效，而不是只存在于磁盘上的 Lotus 仓库中。\n\n请按以下步骤检查：\n\n1. 判断你当前运行在哪个宿主中，例如 Codex、Claude Code 或其他宿主。\n2. 读取当前宿主对应的全局规则文件：\n   - Codex: ~\u002F.codex\u002FAGENTS.md\n   - Claude Code: ~\u002F.claude\u002FCLAUDE.md\n3. 确认文件顶部附近存在 Lotus 四条执行护栏：\n   - Think Before Coding\n   - Simplicity First\n   - Surgical Changes\n   - Goal-Driven Execution\n4. 检查当前宿主的全局 skills 目录，并确认默认 11 个 gstack 顶层 skills 存在：\n   - gstack\n   - gstack-office-hours\n   - gstack-plan-ceo-review\n   - gstack-plan-design-review\n   - gstack-plan-eng-review\n   - gstack-design-review\n   - gstack-review\n   - gstack-investigate\n   - gstack-browse\n   - gstack-qa\n   - gstack-ship\n5. 告诉我当前会话是否已经加载这些全局规则和 skills。\n6. 如果没有加载，告诉我是否需要完全重启宿主或开启新会话。\n7. 如果有缺失，请给出缺失路径、缺失项名称、复现依据和应重新运行的安装命令。\n```\n\n这段提示词只负责验证，不能让旧会话“临时变成”真正的全局会话。真正生效需要满足两个条件：\n\n1. 安装器已经写入宿主全局规则文件和全局 skills。\n2. 宿主开启了一个会读取这些文件的新会话。\n\n## `\u002Fskill` 不显示时怎么排查\n\n`AGENTS.md` 和 `CLAUDE.md` 只保存规则和路由说明，不保存 slash skill 本体。slash skills 还必须存在于宿主自己的全局 skills 目录：\n\n- Codex: `~\u002F.codex\u002Fskills`\n- Claude Code: `~\u002F.claude\u002Fskills`\n\n如果 `\u002Freview`、`\u002Fqa` 或其他 gstack skills 没出现：\n\n1. 重新运行 `install.ps1 -Global` 或 `install.sh --global`。\n2. 确认 `~\u002F.gstack\u002Frepos\u002Fgstack` 存在。\n3. 确认宿主全局 skills 目录中存在对应目录。\n4. 完全重启 IDE \u002F App，让宿主重新扫描全局 skills。\n\n如果 Windows 没有 Git Bash，安装器会写入 bootstrap skills。bootstrap skills 是真实菜单入口，但只负责提示如何补齐完整官方 gstack runtime。\n\n## 常用 Lotus 自带 skills\n\n这些是 Lotus 仓库自身提供的跨平台 skills。官方 gstack skills 由 `garrytan\u002Fgstack` 提供。全局安装或更新 Lotus 后，下面这些 skill 会写入受托管宿主的全局 skills 目录；重启宿主后即可用 `\u002Fskill-name` 调用，例如 `\u002Ftaste-skill`、`\u002Fimage-2`。\n\n| Skill | 用途 |\n|---|---|\n| `test-driven-development` | 严格红绿重构，先写失败测试再写实现 |\n| `frontend-design` | 前端审美与交互质量约束 |\n| `taste-skill` | Taste Skill 前端审美与实现质量约束，强化布局、字体、动效、间距和组件完成度，来源于 `Leonxlnx\u002Ftaste-skill` |\n| `image-2` | GPT Image 2 生图与改图入口，用于图片生成、图片编辑、风格迁移、换背景、透明素材和批量视觉资产 |\n| `ai-progress-workspace` | 搭建带真实 AI 工具进度、中间生成工作区和结构化 artifact 的 Agent 产品 |\n| `web-to-design-md` | 从参考网页、品牌资料、需求文档生成结构化 `design.md` |\n| `debugging-strategies` | 系统性排错，先定位根因再修复 |\n| `security-auditor` | 安全审查，覆盖鉴权、注入、依赖风险等 |\n| `feynman` | 用费曼学习法解释复杂机制 |\n| `polanyi-tacit` | 分析代码背后的隐性业务和组织约束 |\n| `auto-build` | 自动执行依赖安装与构建验证 |\n| `agent-training-loop` | 机器学习式 Agent 编程循环，持续执行复现、检测、执行、检查直到收敛 |\n| `baseline-packager` | 将当前已通过行为封装为 baseline \u002F golden master 回归保护 |\n| `conversion-copywriter` | 官网、落地页、产品页和 CTA 的高转化营销文案 |\n| `powerup` | AI 编程能力速成练习 |\n| `insights` | 使用习惯回顾与优化建议 |\n| `subagent` | 子 Agent 管理与并行任务编排 |\n\n## 仓库结构\n\n```text\nLotus\u002F\n├── core\u002F                 # 全局规则真源\n├── skills\u002F               # Lotus 自带 skills\n├── templates\u002F            # 项目级模板\n├── scripts\u002F              # gstack 托管安装脚本\n├── install.ps1           # Windows 安装器\n└── install.sh            # macOS \u002F Linux 安装器\n```\n\n## 安全与可回滚\n\n- 覆盖前备份：安装器覆盖 `CLAUDE.md` 或 `AGENTS.md` 前会创建 `.bak`。\n- 项目不被隐式修改：`-Global` \u002F `--global` 只写全局路径，不写当前项目目录。\n- 项目模板显式写入：只有运行 `-Project` \u002F `--project` 才会写当前目录。\n- 可卸载：删除对应全局规则文件和 skills 目录，或恢复 `.bak` 即可。\n\n## 更新\n\n进入 Lotus 长期目录后执行：\n\nWindows：\n\n```powershell\ncd C:\\Dev\\Lotus\ngit pull\n.\\install.ps1 -Global\n```\n\nmacOS \u002F Linux：\n\n```bash\ncd ~\u002FDev\u002FLotus\ngit pull\n.\u002Finstall.sh --global\n```\n\n这会刷新 Lotus 全局规则、Lotus 自带 skills、官方 gstack runtime 和默认顶层 gstack skills。项目级文件不会被自动覆盖。\n\n## GitHub Actions 报 `Watch Upstream GStack` 失败\n\nLotus 使用 GitHub Actions 定时检查 `garrytan\u002Fgstack` 上游是否更新。如果 Actions 没有创建 PR 的权限，GitHub 会报：\n\n```text\nGitHub Actions is not permitted to create or approve pull requests.\n```\n\n修复方式：\n\n1. 打开 GitHub 仓库设置。\n2. 进入 `Settings -> Actions -> General -> Workflow permissions`。\n3. 选择 `Read and write permissions`。\n4. 勾选 `Allow GitHub Actions to create and approve pull requests`。\n\n当前 workflow 已做容错：如果权限没开，会写入 workflow summary，不再因为无法创建 PR 而持续刷失败通知。\n","Lotus 是一个用于统一管理 AI 编码助手规则的项目，支持将自定义的工作方式部署到多个 IDE 中。其核心功能包括为 Claude Code 和 Codex 等平台写入全局配置规则，并同步官方 gstack 运行时技能。技术上，Lotus 通过 Shell 脚本实现自动化安装和更新，确保开发环境的一致性。该项目特别适用于需要跨多个开发工具保持一致编码规范和技术栈约束的团队或个人开发者。",2,"2026-06-11 03:52:51","CREATED_QUERY"]