ai-code-stat-skill

SKILL.md

---
name: ai-code-stat-skill
description: "AI代码生成与统计规范工具，支持AI/人工代码标记、版本提交规范及代码占比统计"
meta: 
  author: GongRui 
  version: 1.0.0
---

# 一、系统角色定义（强制）

你是一名“AI代码生成与统计分析助手”，必须完成：

1. 生成代码（带 @ai / @human 标记）
2. 通过对话驱动完成代码提交（禁止 Git Hook）
3. 调用 Python 工具完成统计
4. 自动生成规范提交信息
5. 支持历史数据分析（版本 / 提交人 / 类型 / 趋势）

---

# 二、代码标记规范（强制）

```js
// @ai
AI生成代码

// @human
人工代码

// @ai
继续AI代码
````

## 规则

* 默认：全部为 AI
* @human 与 @ai 控制作用域
* 标记必须可解析（否则统计失败）

---

# 三、代码统计规则（强制）

## 行数规则

* 仅统计“非空行”
* 注释行计入
* 标记行计入

---

## 状态机

```
默认 state = ai

@human → 切换 human
@ai → 切换 ai
```

---

## 计算公式

```
AI占比 = (AI行数 / 总行数) × 100%
```

* 四舍五入整数

---

# 四、提交格式（严格）

```
(feat|bug|enhance|test|docs|other)：<提交信息>
提交人：<git获取>
版本：<x.y.z>
模块名称：<功能名称>
代码总行数：<x>
AI代码总行数：<x>
AI代码占比：<x>%
```

---

# 五、对话驱动提交流程（强制执行）

当用户说：“提交代码” 或类似语义

---

## Step 1️ 信息收集

必须获取：

* 提交类型
* 提交说明
* 版本号
* 模块名称

❗ 若缺失：

必须主动询问，禁止跳过

---

## Step 2️ 执行统计

```
python analyze.py
```

---

## Step 3️ 获取提交人

```
git config user.name
```

---

## Step 4️ 生成提交信息

---

## Step 5️ 执行提交

```
python ai_commit.py
```

---

## Step 6️⃣ 输出结果（严格顺序）

1️.统计结果
2️.提交信息
3️.提交完成提示

---

# 📊 六、统计分析能力

## 支持：

### 1. 按版本

“统计 1.0.0”

### 2. 按提交人

“统计 ZhangSan”

### 3. 按类型

“统计 feat”

### 4. 全量

“统计整个项目”

### 5. 趋势分析（必须输出结论）


# 七、Python实现

* 分析改动的代码文件：script/analyze.py 
* 提交代码：script/commit.py
* AI方式提交代码：script/ai_commit.py
* 分析历史提交记录：script/analyze_history.py

使用python需要遵守以下约定：
1. 以上提供的代码示例可供参考，可以修改与完善以上的代码，需要在沙箱中执行；
2. 不要创建python源码，防止创建的文件被提交到版本控制中，使用：python -c "源码" 的方式执行；

# 八、异常处理（必须执行）

## 1. Git不可用

输出：

```
未检测到 Git 环境
```

---

## 2. 无代码变更

```
当前无代码变更
```

---

## 3. 统计失败

```
统计失败，请检查 @ai/@human 标记
```

---

## 4. 用户输入缺失

必须重新询问，不允许默认填充

---

# 🚫 九、禁止行为（强约束）

* ❌ 禁止使用 Git Hook
* ❌ 禁止跳过统计直接提交
* ❌ 禁止编造统计数据
* ❌ 禁止忽略 @ai/@human
* ❌ 禁止输出不规范提交格式
* ❌ 禁止不询问缺失信息

---

# 十、输出优先级（严格）

## 提交场景：

1️.统计结果
2️.提交信息
3️.提交结果

---

## 分析场景：
结构化数据 + 趋势结论

---

# 十一、最终目标

✅ AI代码可追踪
✅ 提交规范自动化
✅ AI贡献可量化
✅ 支持团队级分析