# @3lineas/grooveskills 中文文档 规范地址：https://npmcn.com/package/%403lineas/grooveskills/ 版本：1\.9\.0 npm 元数据更新时间：2026-11-04T11:40:19.013Z 中文译文更新时间：2026-11-06T20:51:52.890Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%403lineas/grooveskills 原文对照：https://npmcn.com/package/%403lineas/grooveskills/?lang=original 项目主页：https://github.com/3-Lineas/GrooveSkills#readme 源码仓库：https://github.com/3-Lineas/GrooveSkills ## 关键信息（来自 npm 元数据） - 包体积（解压后）：445 kB，66 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：4 个 - 首次发布：2026-10-25T16:47:16.247Z - 最新版本发布：2026-11-04T11:40:18.700Z - 近 30 天下载量：2357（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：15（近 12 个月 15 个） ## 中文简介 多代理CLI以安装有观点的AI编码技能和建筑标准(Hono,React,Next.js等) ## 安装 ```sh npm install @3lineas/grooveskills ``` 也可以使用：`pnpm add @3lineas/grooveskills`、`yarn add @3lineas/grooveskills`、`bun add @3lineas/grooveskills` ## README # Groove 技能 **AI 编码助理的架构标准和持续项目内存** [![npm version](https://img.shields.io/npm/v/@3lineas/grooveskills.svg?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@3lineas/grooveskills) [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![License: MIT](https://img.shields.io/badge/License-MIT-10b981?style=flat-square)](https://opensource.org/licenses/MIT) 授权 **反重力**, (中文(简体) ), **克劳德代码**, (中文(简体) ), **光标**,以及 **双子座** 就像你工程团队的老练成员一样 配合你的清洁码标准 了解你的建筑决定. [概览](https://npmcn.com/package/%403lineas/grooveskills/#readme--overview) 二. 支助 [如何运作](https://npmcn.com/package/%403lineas/grooveskills/#readme--how-it-works) 二. 支助 [快速启动](https://npmcn.com/package/%403lineas/grooveskills/#readme--quick-start) 二. 支助 [项目结构](https://npmcn.com/package/%403lineas/grooveskills/#readme--project-structure) 二. 支助 [技能目录](https://npmcn.com/package/%403lineas/grooveskills/#readme--skills-catalog) * * * ## \* 概览 AI编码助理在每场比赛中分享团队的背景、建筑习惯和经验质量标准时,都发挥出最大的潜力. **Groove 技能** (单位:千美元)`@3lineas/grooveskills`)通过两个互补层为任何存储器配备统一的AI工程控制平面: | 层 | 目的 | 关键惠益 | | :-- | :-- | :-- | | **1\. 核心项目`.grooveskills/`(中文(简体) )** | 内建工程上载,持续内存,并自动安装了"有机和结果驱动"(ODD)3行工作流程. | 每个会话都以您的堆栈、 真实的脚本、 ADR 记录、 结果假说和已核实的核对表为方向. | | **2\. 破解建筑技能** | Battle测试的工程标准包括"清洁码","TypeScript 5.5+","Rust","Python","Valibot","Hono RPC","React 19","Vitest","UX Writing". | 你的AI助手写出干净,模块化,严格打入的代码与你的团队常规相匹配. | * * * ## \* 如何运作 ### 1\. 自动上载和持续内存项目(`.grooveskills/memory/`(中文(简体) ) 这个 **Groove 技能技巧** 自动安装为您的工程的基础, 绝不是一个可选的复选框 : - **第一次设置(自动登入)**: 扫描您的仓库( 软件包管理器, 真) `package.json` 脚本, `tsconfig.json` 路径别名,以及 `src/` 模块),询问您首选的交流语言,并填充 `.grooveskills/memory/context.md`, (中文(简体) ), `decisions.md`, (中文(简体) ), `tasks/00-onboarding.md`, (中文(简体) ), `AGENTS.md`,以及 `CLAUDE.md`。 。 。 . - **随后的运行( 智能更新)**: 检测您已有的绳子, 保存您的记忆和语言设置,以及 **只更新您选择的技能**。 。 。 . - **应要求重新登入(`init`(中文(简体) )**运行 `npx @3lineas/grooveskills init` 随时重新扫描您的项目堆栈并刷新登机上下文 . ### 2\. 智能堆栈检测和轻量级代理参考 GrooveSkills检查您的项目清单(`package.json`, (中文(简体) ), `Cargo.toml`, (中文(简体) ), `pyproject.toml`),预选推荐技能. 所有警犬技能文件都存在 `.grooveskills/skills//`,当代理文件夹收到时 **轻量级参考文件** (~13行) 保存触发元数据而不重复您的 IDE 中的树: - **反重力**数字 : `.agents/skills//SKILL.md` - **克劳德代码**数字 : `.claude/skills//SKILL.md` - **双子星代码辅助**数字 : `.gemini/skills//SKILL.md` - **光标 IDE**数字 : `.cursor/rules/.mdc` ### 3\. 有机和成果驱动开发(ODD)和3-干线工作流程 通过内置 `odd-ai` 财务报告和审定财务报表 `groove-harness` grooveSkills 以混合语言指导您的 AI 助手 **有机和成果驱动发展** 方法: - **有机可适应性**: 勘探、文件和规划的规模与每项请求的复杂性成正比——保持微小的微调并同时赋予主要特征坚实的结构. - **问责制**: 而不是一生成代码就停止(_输出驱动器_),助理定义可测试 **结果假设** 并以实证加以证实_结果驱动_) (中文(简体) ). #### 7级 ODD 寿命周期 1. **授权( 许可门)**:评估您是否授权修改代码 。 问题、审计和审查仍然严格 **只读**。 。 。 . 2. **按比例探索**页:1 `.grooveskills/memory/context.md` ,并仅检查与活动域相关的文件,保存您的符号预算和上下文窗口. 3. **及早解决不确定性**:通过读取代码库来解答技术未知数,只有在产品或设计决定公开时才会提出简明而深思熟虑的问题. 4. **分类语义范围**:根据建筑影响和可逆性而不是行数将请求排入三个行刑道中的一个. 5. **第一写结果假设之前的音轨( E)**: 在编辑关于非部落任务的源文件之前,将计划和正式假设记录在 `.grooveskills/memory/tasks/.md`数字 : > _"通过交付 `[Output / Technical Change]`, (中文(简体) ), `[Outcome / Verifiable Behavior]` 将发生,由 `[Evidence / Test / Build Command]`""("史记")_ 6. **执行比例化的清洁码**: 严格打字后写出干净、模块化代码( 0) `any`(零个巢穴) `if`直接进口,以及 `<200` 每个文件的行. 7. **根据结果进行核查(实证收据)**: 运行确定性检查(类型检查、测试套件、穿插或构建),记录下的实际输出 `## Evidence`,并更新 `## Next` 保持会议连续性. | 处决巷 | 当它激活时 | 代理行为 | | :-- | :-- | :-- | | **第1行——回答** | 问题、代码审查、审计或建筑调查. | **唯读探索.** 检查上下文并用修改为零的文件明确回答. | | **第2行——任务** | 定义良好的特性, 重构, 或者错误修正 . | **成果驱动的执行.** 宣布结果假设 `memory/tasks/.md` 并核对物品,但必须核实 `## Evidence`。 。 。 . | | **第3巷——斯佩克** | 高影响或多领域建筑变化. | **协作设计.** 起草规格和结果假设 `memory/tasks/.md` 在写执行代码之前与您同步. | ### 4\. 多语种、装腔作势的UX通信 选择您的首选语言( E)**西班牙语、英语、葡萄牙语、意大利语或法语**在登机时,每一个验证信息、祝酒和代理互动都保持热情、有说服力和专业性. * * * ## QQ 快速启动 ### 交互式向导( 安装或更新技能) ```bash npx @3lineas/grooveskills ``` ### 强制全工程重新登入( F)`init`(中文(简体) ) ```bash npx @3lineas/grooveskills init ``` ### 非交互模式( CI 和脚本) ```bash # Install skills and initialize harness in Spanish for Claude and Antigravity npx @3lineas/grooveskills --skills odd-ai best-practices hono --agents antigravity claude -l es -y # Re-run full project onboarding non-interactively across all AI assistants npx @3lineas/grooveskills init --agents antigravity claude cursor gemini -l es -y ``` ### CLI 选项参考 | 命令/ 旗帜 | 说明 | 示例 | | :-- | :-- | :-- | | `init` | 强制重运行上载的项目, 堆栈扫描和内存上下文 | `npx @3lineas/grooveskills init` | | `-s, --skills ` | 空格分隔的要安装的技能标识列表 | `--skills odd-ai best-practices` | | `-a, --agents ` | 目标人工智能助理`antigravity`, (中文(简体) ), `claude`, (中文(简体) ), `cursor`, (中文(简体) ), `gemini`(中文(简体) ) | `--agents antigravity cursor` | | `-l, --language ` | 设置用于创建用户副本的语言( N)`es`, (中文(简体) ), `en`, (中文(简体) ), `pt`, (中文(简体) ), `it`, (中文(简体) ), `fr`(中文(简体) ) | `-l es` | | `-y, --yes` | 自动确认更新现有技能 | `-y` | * * * ## 项目结构 ```text my-project/ ├── .grooveskills/ │ ├── config.json # Manifest of active skills, agents, language & harness state │ ├── skills/ # Canonical single source of truth for installed skills │ └── memory/ # Persistent project memory (Core Harness control plane) │ ├── context.md # Auto-scanned stack, scripts, aliases & architecture map │ ├── decisions.md # Architecture Decision Records (ADR) │ └── tasks/ # 00-onboarding.md & tasks with Outcome Hypotheses ├── .agents/skills//SKILL.md # Lightweight reference pointer -> .grooveskills/skills//SKILL.md ├── .claude/skills//SKILL.md # Lightweight reference pointer -> .grooveskills/skills//SKILL.md ├── .gemini/skills//SKILL.md # Lightweight reference pointer -> .grooveskills/skills//SKILL.md ├── .cursor/rules/.mdc # Lightweight reference rule -> .grooveskills/skills//SKILL.md └── AGENTS.md / CLAUDE.md # Concise harness pointer ``` * * * ## 技能目录 | 技能标识 | 名称 | 建筑重点 | 自动选择规则 | | :-- | :-- | :-- | :-- | | `groove-harness` | **Groove 技能技巧** | ODD 三行工作流程(答复、任务、Spec),登机协议、ADR记录和 `.grooveskills/memory/`。 。 。 . | **核心功率( 一直安装)** | | `odd-ai` | **有机和结果驱动(ODD)** | AI剂的7步ODD协议:授权,探索,分类,结果假设,以及证据收据. | **默认( 通用)** | | `best-practices` | **通用最佳做法** | 多语言清洁码,严格打字(零) `any`),警卫条款,以及 `<200` 每个文件的行. | **默认( 通用)** | | `ux-writing` | **UX 写入和缩微复制** | 温取相克相克相克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克. | **默认( 通用)** | | `docs-standards` | **文档和 ADR 标准** | 英文文档规则,相对的POSIX链接,有弹性的美人鱼图,ADR寿命周期,以及意向指示. | **默认( 通用)** | | `error-handling-logging` | **处理日志出错( L)** | 输入的可预计出错流量 `AppError`, (中文(简体) ), `ActionResponse` 合同和结构化伐木. | **默认( 通用)** | | `clean-architecture-ddd` | **清洁建筑和 DDD** | 域驱动的模块边界,单目的动作,纯函数,以及不可变的数据模型. | **默认( 通用)** | | `external-service-adapters` | **外部服务适配器和包装器** | 解码域端口,销售商SDK包装,以及交换支付网关,电子邮件和API的可适配器. | **默认( 通用)** | | `storage-file-adapters` | **存储文件适配器( S3, R2, Supabase) (F)** | 对象存储端口,上传,预先签名的URL,以及没有寄存器抽象的流出. | **默认( 通用)** | | `auth-rbac-policies` | **Auth适配器和RBAC/ABAC政策** | 认证适配端口 `AuthenticatedActor` 以及无副作用的纯授权政策. | **默认( 通用)** | | `controller-orchestration-queues` | **控制管弦乐和队列** | 原子动作,控制器序列/交易,以及可互换的背景等式适配器. | **默认( 通用)** | | `webhook-idempotency` | **Webhook 验证符和同上** | 密码学 HMAC webhook 校验器(Stripe, Svix, MercadoPago)和原子等能卫. | **默认( 通用)** | | `caching-rate-limiting` | **缓存附加限制( R)** | 声明 `cache.remember` 包装和滑窗率限制适配器(Redis, KV, Memory). | **默认( 通用)** | | `env-feature-flags` | **失败快信和特性旗** | Boot-time-default-fast Valibot 环境验证和脱钩功能旗适配器(PostHog, LD). | **默认( 通用)** | | `typescript-clean` | **类型脚本清洁码( 5. 5+)** | 现代类型脚本( S)`satisfies`歧视的工会, `const` 通用软件, `unknown` (缩小范围). | `typescript` 内 `package.json` | | `rust-clean` | **粗口清洁码(Rust 2024)** | 平庸的鲁斯特: `let-else` 护卫条款, 0 `.unwrap()`, (中文(简体) ), `thiserror` 键入错误和新类型. | `Cargo.toml` 在项目根中 | | `python-clean` | **Python 清洁码( Python 3. 12+)** | 现代 Python: 守护条款( 无嵌入式 ), 严格打字( 0) `Any`),uv,Ruff,和平赖特. | `pyproject.toml` 编号 : `requirements.txt` | | `valibot-validation` | **Valibot Schema 验证** | 以模块化 Valibot 计划进行边界验证(`* as v from "valibot"`)和礼相误. | `valibot` 内 `package.json` | | `testing-vitest` | **检测标准** | 使用Arange-Act-Assert(AAA)和内相假构的快速,定型测试套件. | `vitest` 内 `package.json` | | `hono` | **霍诺建筑(Valibot)** | 具有稀疏路由处理器的可缩放Hono API(`createRouteHandler`),瓦利博特验证,以及孤立的行动. | `hono` 内 `package.json` | | `workers-rpc-precision` | **工人RPC和精密计算** | Cloudflare 工人 本地的 RPC( 本地`WorkerEntrypoint` 编号 : `Service`)和小数算术(`Decimal` + 键 `ROUND_HALF_UP`) (中文(简体) ). | `wrangler` 编号 : `@cloudflare/workers-types` | | `frontend-design` | **前端视觉设计和身份** | 区别而有见解的视觉UI设计避免了AI的陈词滥调:活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活字活. | `react`, (中文(简体) ), `next`, (中文(简体) ), `vue`, (中文(简体) ), `svelte`, (中文(简体) ), `tailwindcss` | | `react-core` | **反应核心基本要素** | 现代反应基本要素:严格意义上说,否 `React.FC`,纯组件,不可变状态,核心钩,并形成域钩. | `react` 内 `package.json` | | `react-advanced` | **反应 19 高级编译器( C)** | 反应编译器自动渲染,同时渲染, `use()`,动作和RSC边界. | `react` 内 `package.json` | | `react-create-page` | **反应页面视图架构( V)** | 申报页协调员`<50` ),自定义域钩,和 Valibot + Formisch 形式. | `react` 内 `package.json` | * * * ## 许可证 释放 [MIT 许可证](https://opensource.org/licenses/MIT) © [3行线](https://3lineas.com/) ## 常见问题 ### @3lineas/grooveskills 是什么？ 多代理CLI以安装有观点的AI编码技能和建筑标准\(Hono,React,Next\.js等\) ### 如何安装 @3lineas/grooveskills？ 在项目目录运行 npm install @3lineas/grooveskills，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 grooveskills，可以用 npx grooveskills 直接运行。 ### @3lineas/grooveskills 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @3lineas/grooveskills 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @3lineas/grooveskills 可以商用吗？ @3lineas/grooveskills 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @3lineas/grooveskills 的下载量有多少？ 根据 npm 官方下载统计，@3lineas/grooveskills 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,357 次，日均约 79 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @3lineas/grooveskills 还在维护吗？ 最新版本 1\.9\.0 发布于 2026/11/04（3 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/10/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。