@zero-ai-bits/ai-coding-skills

专为 AI 编程助手打造的极简、高效、纯净的 Skills（技能）集合。

本依赖包封装了一套高约束力的 AI 行为控制协议与规范，旨在解决 AI 辅助编程中常见的“废话多”、“乱改代码”、“覆盖用户修改”等痛点，打造最顺畅的人机结对编程体验。

📦 包含的技能 (Skills)

本套件目前提供以下 4 个核心 Skill：

1. 代码输出协议 (code-output-style-protocol)

• 定位：AI 行为底座，强制交互规范。
• 核心机制：
  • 明确授权与防覆盖：未收到明确修改指令前只做分析；修改前必先读取最新代码基准，绝不依赖记忆盲写。
  • 先请示后执行：无论是修改还是新建，必须先以一句话说明原因，等待用户确认后才执行输出。
  • 严禁废话：干掉所有的“好的”、“根据您的要求”等啰嗦开场白。
  • 增量输出：修改代码时坚决只输出差异部分（附带前后3行上下文），拒绝全文件重写。

2. 前端通用代码规范 (frontend-code-style)

• 定位：纯粹的、框架无关的前端通用代码约定。
• 核心机制：
  • 命名协议：统一变量 camelCase，组件 PascalCase 等跨框架通用的命名规范。
  • 语法格式：约束缩进、引号、单行 if、以及统一的标签闭合规则（适用于 JSX / Vue / HTML）。
  • 注释约定：强制使用 JSDoc 并规定了必须注释的触发门槛。
  • 指令禁区：禁止 AI 擅自执行环境安装命令，强制增量上下文输出。

3. 多 Agent 研发流水线 (swarm-crud-coordinator)

• 定位：通用的多 Agent 集群统筹引擎。
• 核心机制：
  • 四大专员串行协作：统筹 PM-Agent（需求架构）、API-Agent（接口设计）、Dev-Agent（前端开发）与 QA-Agent（规范审查）高效协作。
  • 高度解耦：无特定组件或项目架构绑定，由 PM-Agent 动态提供架构建议。
  • 动态规范注入：开发与审查全链路动态遵循工作区配置的 frontend-code-style，实现跨项目泛用。

4. Git 提交极速格式化 (git-commit-formatter)

• 定位：极速、精准的提交信息生成器。
• 核心机制：
  • 自动拉取：静默调用 git diff --cached 获取上下文，不用你贴代码。
  • 极速纯文本：只吐出一条最准确的 Commit Message，不加 Markdown 围栏，不给多选项。
  • 强原子性：只提炼核心变更类型，禁止 feat and fix 拼接。
  • 字数封顶：Body 说明最多 3 句话，坚决杜绝长篇小作文。

🚀 安装与使用

方式一：命令行一键安装 (推荐)

如果你已经在项目中安装了此包，可以直接通过 npm 运行安装向导：

npx "@zero-ai-bits/ai-coding-skills

向导会自动探测你项目中的 AI 配置目录（如 .agent/skills, .agents/skills 等），你也可以直接敲回车使用默认路径。

方式二：指定目录安装

如果你想把 skills 安装到自定义目录，可以使用 --dir（或 -d）参数：

npx "@zero-ai-bits/ai-coding-skills --dir path/to/your/skills

🛠️ 生效方式

安装完成后，确保这些 Skill 文件夹已经存在于你的 IDE（如 Cursor、Windsurf、Antigravity 等）的自定义代理/技能配置目录下。 重启 AI 编程助手或开启新对话后，这些规则将自动接管 AI 的大脑。

💡 协议宗旨

“节省 Token，不做无用输出，不废话，但保持自然。”