🛠️ skill-forge (AI Agent Skill 工作空间)

精心打磨的 AI Agent Skill 设计与智能分发工作空间。

skill-forge 提供了一套标准化工具，使您可以轻松编写兼容 Codex, Gemini, Claude Code, Cursor 等支持 SKILL.md 规范的 AI Agent 并在不同项目中一键部署。

📂 1. 目录结构

skill-forge/
├── README.md                (英文主指南)
├── README.ko.md             (韩文主指南)
├── README.zh.md             (本中文主指南)
├── package.json             (CLI 依赖配置)
├── bin/
│   └── cli.js               (Skill 部署与本地化 CLI 工具)
├── skills/
│   ├── bugfix/              (回归测试驱动的错误修复工作流 Skill)
│   │   ├── SKILL.md
│   │   ├── SKILL.ko.md
│   │   ├── SKILL.zh.md
│   │   ├── README.md
│   │   ├── README.ko.md
│   │   └── README.zh.md
│   ├── feature-dev/         (TDD 功能开发工作流 Skill)
│   │   ├── SKILL.md
│   │   ├── SKILL.ko.md
│   │   ├── SKILL.zh.md
│   │   ├── README.md
│   │   ├── README.ko.md
│   │   └── README.zh.md
│   ├── refactoring/         (测试保护的行为保持重构 Skill)
│   │   ├── SKILL.md
│   │   ├── SKILL.ko.md
│   │   ├── SKILL.zh.md
│   │   ├── README.md
│   │   ├── README.ko.md
│   │   └── README.zh.md
│   └── ultra-grill-me/      (Socratic 提问施压验证 Skill)
│       ├── SKILL.md
│       ├── SKILL.ko.md
│       ├── SKILL.zh.md
│       ├── README.md
│       ├── README.ko.md
│       ├── README.zh.md
│       ├── references/      (细分领域提问参考库)
│       ├── examples/        (Trigger 测试用例)
│       └── evals/           (提问规范自动化 Grader)
├── templates/
│   └── skill-template/      (新 Skill 创建模板)
└── docs/
    ├── authoring-guide.md   (Skill 编写指南)
    ├── naming.md            (命名规范)
    └── testing.md           (测试与 Evals 验证指南)

🏆 2. 已发布 Skill 列表

| Skill 名称 | 核心目的与简介 | 状态 | | :--- | :--- | :--- | | bugfix | 通过 Reproduce → Root Cause → Regression Test → Minimal Fix → Verify 的流程修复错误、失败或回归行为。 | Released (v1.0.0) | | feature-dev | 通过 Red → Green → Refactor 的严格 TDD 流程实现新的产品或代码行为。 | Released (v1.0.0) | | refactoring | 通过 Baseline → Transform → Same Tests 的保守流程，在保持外部行为不变的前提下重构代码。 | Released (v1.0.0) | | ultra-grill-me | 通过苏格拉底式提问（一次只问一个问题）压力测试用户的开发计划、系统设计、商业策略和个人决策，从而在代码编写前消除模糊性。 | Released (v1.0.0) 🎯 |

🚀 3. CLI 快速部署工具 (skill-forge 或 npx @bhoon716/skill-forge)

通过轻量化 CLI 可以自动根据语言选项映射，并将 Skill 复制部署到对应的 Agent 本地或全局配置路径中。

[!TIP] 全局命令更轻松运行 (skill-forge)： 您可以全局安装此工具，以便直接运行 skill-forge 启动交互式安装模式。

# 1. 全局安装 (仅需一次)
$ npm install -g @bhoon716/skill-forge

# 2. 快捷运行交互式安装模式
$ skill-forge

💡 命令行实例

# 1. 以中文版部署到所有支持的本地 Agent 项目路径 (默认值: global)
$ skill-forge install ultra-grill-me --lang zh

# 2. 以中文版部署到本地 Claude Code 路径
$ skill-forge install ultra-grill-me --lang zh --agent claude

# 3. 以英文版部署到本地 Cursor 路径
$ skill-forge install ultra-grill-me --lang en --agent cursor

# 4. 显式部署到所有支持的本地 Agent 项目路径
$ skill-forge install ultra-grill-me --lang zh --agent global

# 5. 安装功能开发 TDD 工作流 Skill
$ skill-forge install feature-dev --lang en --agent codex

# 6. 安装回归测试驱动的错误修复工作流 Skill
$ skill-forge install bugfix --lang en --agent codex

# 7. 安装行为保持重构工作流 Skill
$ skill-forge install refactoring --lang en --agent codex

# 8. 一键中文部署工作空间内的所有 Skill 到全部支持的本地 Agent 路径
$ skill-forge install all --lang zh

⚙️ 选项说明

• -l, --lang <en|ko|zh>: 选择部署的翻译语系 (默认值: en)
• -a, --agent <codex|gemini|claude|cursor|copilot|global>: 目标工具的环境路径映射 (默认值: global)
  • codex, gemini: ./.agents/skills
  • claude: ./.claude/skills
  • cursor: ./.cursor/skills
  • copilot: ./.copilot/skills
  • global: 安装到以上全部支持的本地 Agent 路径
• --dry-run: 仅模拟复制映射过程，不实际写入文件

✍️ 4. 协作开发规范

[!IMPORTANT] 在此仓库贡献新 Skill 时，请务必遵守以下三条原则:

1. 🎯 单一职责原则 (Single Responsibility): 每个 Skill 的设计必须专注于解决 docs/authoring-guide.md 中定义的一个具体的、高价值的重复工作流。
2. 🌐 翻译后缀规范 (Localization Suffixes): 必须同时提供对应语言的后缀文件（例如：SKILL.zh.md, SKILL.ko.md 以及英文默认版的 SKILL.md），以支撑 CLI 解析。
3. 🧪 运行回归测试 (Regression Proof): 进行任何修改后，必须运行 evals/check_evals.py 自动化评测，以确保提问结构和 Process Adherence 指标没有退化。

📄 开源协议

MIT License. 欢迎将此项目框架用于您团队的内部自定义 Agent Skills 分发枢纽。