# git-skills

**Repository Path**: masterkgw/git-skills

## Basic Information

- **Project Name**: git-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-08
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# git-skills

个人 AI Skills 管理仓库，用于集中存放、同步和迭代可对外同步的 skill。

当前只保留 `business-code-loop`，用于业务代码开发中的目标规划、步骤拆解、实施、验证和有上限循环。

---

## 目录

- [已有 Skill](#已有-skill)
  - [business-code-loop](#business-code-loop)
- [仓库规范](#仓库规范)
  - [目录结构](#目录结构)
  - [技能元数据模板](#技能元数据模板)
- [技能注册流程](#技能注册流程)
- [版本号规范](#版本号规范)
- [技能状态说明](#技能状态说明)
- [注意事项](#注意事项)

---

## 已有 Skill

### business-code-loop

- **名称**：业务代码 Loop 开发
- **目录**：[business-code-loop](./business-code-loop/)
- **主文件**：[SKILL.md](./business-code-loop/SKILL.md)
- **元信息**：[METADATA.md](./business-code-loop/METADATA.md)
- **版本**：v0.1.0
- **状态**：开发中

`business-code-loop` 面向业务代码开发场景，用 PDCA / Loop 的方式约束智能体工作过程：先展示目标、整体步骤、验证规则和循环终止条件，等待用户确认后再执行；随后完成头脑风暴、设计、计划、实施、验证和有上限的失败重试。

它重点解决这些问题：

- 让目标、步骤、验证规则和停止条件在执行前可见。
- 让验证规则明确到通过标准、失败标准、证据记录和失败后处理。
- 让设计文档、执行计划、状态文档和每轮迭代记录都有迹可循。
- 在未达目标时按上限循环处理，避免无限修改或无证据完成。

---

## 仓库规范

### 目录结构

```
git-skills/
├── README.md               # 本文件，技能总览与规范说明
├── SKILL_REGISTRY.md       # 技能注册表（所有技能的索引）
└── {skill-name}/           # 每个技能独立目录，以技能名称命名
    ├── SKILL.md            # 技能主文件（核心 prompt 或逻辑）必须大写，
    └── METADATA.md         # 技能元数据（见下方模板）
```

### 技能元数据模板

每个技能目录下须包含 `METADATA.md`，格式如下：

```markdown
## 技能元数据

| 字段       | 值                  |
|------------|---------------------|
| 技能名称   | （必填）            |
| 技能 ID    | （必填，英文小写，如 code-review）|
| 技能描述   | （必填，一句话说明技能用途）|
| 技能版本   | （必填，如 v1.0.0） |
| 负责人     | （必填，姓名）      |
| 负责人工号 | （必填）            |
| 负责人邮箱 | （选填）            |
| 所属团队   | （选填）            |
| 创建日期   | （必填，YYYY-MM-DD）|
| 最后更新   | （必填，YYYY-MM-DD）|
| 状态       | （必填：开发中 / 已发布 / 已废弃）|
| 适用模型   | （选填，如 claude-sonnet-4-6）|

## 更新日志

| 版本    | 日期       | 变更说明         | 操作人 |
|---------|------------|------------------|--------|
| v1.0.0  | YYYY-MM-DD | 初始版本         | 姓名   |
```

---

## 技能注册流程

1. **新建目录**：在仓库根目录下以技能 ID 为名新建文件夹
2. **填写元数据**：参照上方模板，在目录内创建 `METADATA.md` 并完整填写所有必填字段
3. **编写技能内容**：在 `skill.md` 中编写技能的核心内容
4. **更新注册表**：在 `SKILL_REGISTRY.md` 中添加该技能的索引记录
5. **提交变更**：提交到 Git，并按需要同步到远程仓库

---

## 版本号规范

遵循语义化版本（Semantic Versioning）：

```
v{MAJOR}.{MINOR}.{PATCH}
```

| 版本段  | 说明                           |
|---------|-------------------------------|
| MAJOR   | 不兼容的重大变更               |
| MINOR   | 向后兼容的功能新增             |
| PATCH   | 向后兼容的问题修复或文案优化   |

---

## 技能状态说明

| 状态   | 说明                                   |
|--------|----------------------------------------|
| 开发中 | 技能正在开发或测试，不建议生产使用     |
| 已发布 | 技能已通过审核，可在生产环境中使用     |
| 已废弃 | 技能不再维护，请迁移到替代技能         |

---

## 注意事项

- 每个技能的负责人对该技能的内容质量和版本迭代负责
- 技能内容变更须同步更新版本号与更新日志
- 废弃技能须在 `METADATA.md` 中注明替代技能
- 不提交本地 IDE 配置、系统缓存文件、临时压缩包或敏感凭证