Groove 技能
AI 编码助理的架构标准和持续项目内存
授权 反重力, (中文(简体) ), 克劳德代码, (中文(简体) ), 光标,以及 双子座 就像你工程团队的老练成员一样 配合你的清洁码标准 了解你的建筑决定.
* 概览
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/<skill>/,当代理文件夹收到时 轻量级参考文件 (~13行) 保存触发元数据而不重复您的 IDE 中的树:
- 反重力数字 :
.agents/skills/<skill>/SKILL.md - 克劳德代码数字 :
.claude/skills/<skill>/SKILL.md - 双子星代码辅助数字 :
.gemini/skills/<skill>/SKILL.md - 光标 IDE数字 :
.cursor/rules/<skill>.mdc
3. 有机和成果驱动开发(ODD)和3-干线工作流程
通过内置 odd-ai 财务报告和审定财务报表 groove-harness grooveSkills 以混合语言指导您的 AI 助手 有机和成果驱动发展 方法:
- 有机可适应性: 勘探、文件和规划的规模与每项请求的复杂性成正比——保持微小的微调并同时赋予主要特征坚实的结构.
- 问责制: 而不是一生成代码就停止(输出驱动器),助理定义可测试 结果假设 并以实证加以证实结果驱动) (中文(简体) ).
7级 ODD 寿命周期
- 授权( 许可门):评估您是否授权修改代码 。 问题、审计和审查仍然严格 只读。 。 。 .
- 按比例探索页:1
.grooveskills/memory/context.md,并仅检查与活动域相关的文件,保存您的符号预算和上下文窗口. - 及早解决不确定性:通过读取代码库来解答技术未知数,只有在产品或设计决定公开时才会提出简明而深思熟虑的问题.
- 分类语义范围:根据建筑影响和可逆性而不是行数将请求排入三个行刑道中的一个.
- 第一写结果假设之前的音轨( E): 在编辑关于非部落任务的源文件之前,将计划和正式假设记录在
.grooveskills/memory/tasks/<slug>.md数字 :"通过交付
[Output / Technical Change], (中文(简体) ),[Outcome / Verifiable Behavior]将发生,由[Evidence / Test / Build Command]""("史记") - 执行比例化的清洁码: 严格打字后写出干净、模块化代码( 0)
any(零个巢穴)if直接进口,以及<200每个文件的行. - 根据结果进行核查(实证收据): 运行确定性检查(类型检查、测试套件、穿插或构建),记录下的实际输出
## Evidence,并更新## Next保持会议连续性.
| 处决巷 | 当它激活时 | 代理行为 |
|---|---|---|
| 第1行——回答 | 问题、代码审查、审计或建筑调查. | 唯读探索. 检查上下文并用修改为零的文件明确回答. |
| 第2行——任务 | 定义良好的特性, 重构, 或者错误修正 . | 成果驱动的执行. 宣布结果假设 memory/tasks/<slug>.md 并核对物品,但必须核实 ## Evidence。 。 。 . |
| 第3巷——斯佩克 | 高影响或多领域建筑变化. | 协作设计. 起草规格和结果假设 memory/tasks/<slug>.md 在写执行代码之前与您同步. |
4. 多语种、装腔作势的UX通信
选择您的首选语言( E)西班牙语、英语、葡萄牙语、意大利语或法语在登机时,每一个验证信息、祝酒和代理互动都保持热情、有说服力和专业性.
QQ 快速启动
交互式向导( 安装或更新技能)
npx @3lineas/grooveskills
强制全工程重新登入( F)init(中文(简体) )
npx @3lineas/grooveskills init
非交互模式( CI 和脚本)
# 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...> | 空格分隔的要安装的技能标识列表 | --skills odd-ai best-practices |
-a, --agents <agents...> | 目标人工智能助理antigravity, (中文(简体) ), claude, (中文(简体) ), cursor, (中文(简体) ), gemini(中文(简体) ) | --agents antigravity cursor |
-l, --language <lang> | 设置用于创建用户副本的语言( N)es, (中文(简体) ), en, (中文(简体) ), pt, (中文(简体) ), it, (中文(简体) ), fr(中文(简体) ) | -l es |
-y, --yes | 自动确认更新现有技能 | -y |
项目结构
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>/SKILL.md # Lightweight reference pointer -> .grooveskills/skills/<skill>/SKILL.md
├── .claude/skills/<skill>/SKILL.md # Lightweight reference pointer -> .grooveskills/skills/<skill>/SKILL.md
├── .gemini/skills/<skill>/SKILL.md # Lightweight reference pointer -> .grooveskills/skills/<skill>/SKILL.md
├── .cursor/rules/<skill>.mdc # Lightweight reference rule -> .grooveskills/skills/<skill>/SKILL.md
└── AGENTS.md / CLAUDE.md # Concise harness pointer <!-- grooveskills:harness -->
技能目录
| 技能标识 | 名称 | 建筑重点 | 自动选择规则 |
|---|---|---|---|
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<T>)和小数算术(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 |