用途：为 LeanSpec 项目贡献代码、修复缺陷、发布版本时提供统一开发指南，覆盖编码、命令、发布、CI/CD 与 runner 研究。
主要能力与约定：强制使用 pnpm（禁用 npm/yarn）；遵循 DRY；测试聚焦业务逻辑与数据完整性；利用 Turborepo 缓存；所有面向用户的字符串必须同时提供 en 与 zh-CN；Rust 代码须通过 cargo clippy -- -D warnings。UI 须支持明暗主题，使用 shadcn/ui，可点击项加 cursor-pointer，缺陷修复须附回归测试。
常用命令：pnpm install、pnpm dev、pnpm dev:watch、pnpm dev:web、pnpm dev:desktop、pnpm build、pnpm build:rust、pnpm build:rust:release、pnpm typecheck、pnpm test、pnpm test:rust、pnpm format、pnpm cli。验证用 pnpm pre-push（typecheck + clippy）与 pnpm pre-release（build + typecheck + test + lint）。标记工作完成前必须运行 pnpm typecheck。
发布流程：npm version patch 后执行 pnpm sync-versions，再 pnpm pre-release，提交并 git push --follow-tags，最后 gh release create vX.X.X 触发发布工作流。开发版可用 gh workflow run publish.yml --field dev=true。版本以根 package.json 为唯一来源，平台包须先于主包发布。
变更日志：遵循 Keep a Changelog 与语义化版本，仅记录已交付变更，分类为 Added、Changed、Fixed、Deprecated、Removed、Security、Technical。
CI/CD：使用 gh CLI 查看与触发工作流，如 gh run list、gh run view <run-id>、gh run view <run-id> --log-failed、gh run rerun <run-id> --failed。
适用场景：LeanSpec 仓库的日常开发、发布、CI 排障与 runner 生态调研。限制：具体平台支持、收费与效果资料暂未提供。