lyf-comet-rules

来伊份团队 AI 编码规则包。它把 Comet 工作流、团队规则、Git hooks 一次性装好，让 AI coding 在同一套约束下工作。

最快开始

交互式安装：

npx -y lyf-comet-rules@latest setup

无交互安装 Claude Code：

npx -y lyf-comet-rules@latest setup --platform claude

验证是否生效：

lyf-rules verify

只需要记住这三个命令。setup 会先选择平台，然后自动初始化 Comet、分发 lyf 规则、安装 Git hooks。

日常怎么用

# 1. 开始需求
/comet "实现订单列表查询"

# 2. 收尾或提交前验证
lyf-rules verify

# 3. 规则更新
lyf-rules refresh

setup 会做什么

lyf-rules setup 是推荐入口，会自动完成：

1. 选择 AI 编码平台
2. 安装或初始化 Comet
3. 分发 lyf 团队规则和 lyf skills
4. 安装 .lyf/hooks
5. 配置 git core.hooksPath=.lyf/hooks

如果需要 CI 模板：

lyf-rules setup --full

常用命令

| 命令 | 用途 | |------|------| | lyf-rules setup | 一站式初始化，普通用户首选 | | lyf-rules verify | 收尾、提交前、CI 前统一验证 | | lyf-rules doctor --strict | 排查安装和约束是否完整 | | lyf-rules refresh | 更新 Comet 和 lyf 规则 | | lyf-rules hooks --overwrite | 修复或重装 Git hooks |

生成文件在哪里

普通用户只需要知道：

• .lyf/：lyf 规则、hooks、checksum 的管理区，不要手动改；配置和 hooks 会只读，CodeGraph 数据库等运行态文件保持可写
• .claude/、.cursor/ 等平台目录：给 AI 平台读取的入口，多数文件会指向 .lyf/

如果 .lyf/ 文件被改坏，用下面命令修复：

lyf-rules refresh
lyf-rules hooks --overwrite

排障

使用最新版本重新跑：

npx -y lyf-comet-rules@latest setup --platform claude

刚发布新版本时 npm 可能有 latest 缓存，可临时指定版本：

npm view lyf-comet-rules version
npx -y lyf-comet-rules@<version> setup --platform claude

更多文档

• USAGE.md：完整用户手册和排障
• MAINTENANCE.md：维护者说明
• CHANGELOG.md：版本记录