技能描述
这是一个用于统计代码中 AI 生成比例的 skill。它支持多种统计模式（最新 commit、暂存区、指定 commit、commit 范围），能够识别 AI 生成的代码标记，并生成详细的个人报告。
触发命令: /ai-stats [command] [options] 或 /aistats [command] [options]
命令用法
子命令模式（推荐）
/ai-stats # 默认：统计最新 commit
/ai-stats staged # 统计暂存区内容
/ai-stats commit <hash> # 统计指定 commit
/ai-stats range <hash1>..<hash2> # 统计 commit 范围完整参数格式：
/ai-stats [command] [commit-hash|range] [task-name] [git-username]兼容模式（旧用法）
/ai-stats # 使用默认 commit message 和 Git 用户名
/ai-stats "用户管理模块" # 指定需求名，使用默认 Git 用户名
/ai-stats "用户管理模块" aurorayang # 指定需求名和用户名子命令详解
1. 最新 Commit 统计（默认）
统计最近一次 commit 的代码变更。
# 基本用法
/ai-stats
# 指定需求名
/ai-stats "用户管理模块"
# 指定需求名和用户名
/ai-stats "用户管理模块" aurorayang2. 暂存区统计
统计当前暂存区（staged）的代码变更。
# 基本用法
/ai-stats staged
# 指定需求名
/ai-stats staged "用户管理模块"
# 指定需求名和用户名
/ai-stats staged "用户管理模块" aurorayang3. 指定 Commit 统计
统计特定 commit hash 的代码变更。
# 基本用法
/ai-stats commit abc1234
# 指定需求名
/ai-stats commit abc1234 "用户管理模块"
# 指定需求名和用户名
/ai-stats commit abc1234 "用户管理模块" aurorayang4. Commit 范围统计
统计两个 commit 之间的所有代码变更。
# 基本用法
/ai-stats range abc1234..def5678
# 指定需求名
/ai-stats range abc1234..def5678 "用户管理模块"
# 指定需求名和用户名
/ai-stats range abc1234..def5678 "用户管理模块" aurorayang参数说明
| 参数 | 位置 | 说明 | 默认值 |
|---|---|---|---|
command | 第1个 | 子命令：staged、commit、range 或省略 | 省略=最新 commit |
commit-hash | 第2个 | 当 command 为 commit 时的目标 hash | - |
range | 第2个 | 当 command 为 range 时的范围，格式 hash1..hash2 | - |
task-name | 倒数第2个 | 需求/任务名称 | 当前 commit message |
git-username | 最后1个 | Git 用户名 | git config user.name |
报告命名规则：
- 有需求名：
ai-code-report-YYYY-MM-DD-需求名.md - 无需求名：
ai-code-report-YYYY-MM-DD-HHmmss.md
重复需求处理：
- 相同需求名的报告会自动更新，而不是创建新文件
- 更新时会保留原文件，更新内容和统计信息
功能特性
- 多模式支持：最新 commit、暂存区、指定 commit、commit 范围
- 自动检测代码变更
- 识别 AI 生成代码标记（
@ai-generated、@ai-generated-start/end） - 统计 AI 生成代码与人工编写代码的比例
- 生成个人专属报告（按登录用户名分类存储）
- 支持多种文件类型（.ts,.tsx,.js,.jsx,.mpx,.vue 等）
执行流程
1. 解析命令参数
- 识别子命令（staged/commit/range）
- 提取 commit hash 或范围
- 获取需求名和用户名
2. 获取用户信息
- 通过
git config user.name获取当前 Git 用户名 - 作为报告存储目录名称
3. 收集代码变更
根据模式选择不同的 Git 命令：
- 最新 commit:
git show --numstat HEAD - 暂存区:
git diff --cached --numstat - 指定 commit:
git show --numstat <hash> - Commit 范围:
git diff --numstat <range>
4. 识别 AI 生成代码
- 扫描文件头部的
@ai-generated标记 - 扫描文件中的
@ai-generated-start和@ai-generated-end标记 - 统计 AI 生成的代码行数
5. 计算统计数据
- 总变更文件数
- 总新增行数 / 总删除行数
- AI 生成文件数 / AI 生成行数
- AI 代码占比（按文件数和行数分别计算）
6. 生成个人报告
- 报告路径:
{project-root}/AI-Generate/{username}/ - 文件名格式:
ai-code-report-{YYYY-MM-DD-需求名}.md - 内容包含:
- 本次提交统计摘要 - AI 生成代码详细清单 - 文件级别统计 - 历史累计统计（如存在历史报告）
报告内容结构
# AI 代码生成统计报告
**生成时间**: YYYY-MM-DD HH:mm:ss
**统计人**: {username}
**提交哈希**: {commit-hash}
**提交信息**: {commit-message}
---
## 统计摘要
| 指标 | 数值 |
|------|------|
| 变更文件总数 | {n} |
| 新增代码行数 | {n} |
| 删除代码行数 | {n} |
| AI 生成文件数 | {n} |
| AI 生成代码行数 | {n} |
| **AI 代码占比** | **{x}%** |
---
## AI 生成文件清单
### 新增文件（AI 生成）
| 序号 | 文件路径 | 类型 | AI 生成行数 |
|------|----------|------|-------------|
| 1 | `src/...` | TypeScript | 150 |
### 修改文件（含 AI 生成部分）
| 序号 | 文件路径 | AI 生成行数 | 修改说明 |
|------|----------|-------------|----------|
| 1 | `src/...` | 45 | 新增函数 |
---
## 文件详细统计
### {文件路径}
- 文件类型: {type}
- 新增行数: {n}
- 删除行数: {n}
- AI 生成行数: {n}
- AI 占比: {x}%
---
## 历史累计统计
| 指标 | 本次 | 累计 | 总计 |
|------|------|------|------|
| 提交次数 | 1 | {n} | {n} |
| AI 生成文件数 | {n} | {n} | {n} |
| AI 生成代码行数 | {n} | {n} | {n} |
---
*报告由 AI Code Stats Skill 自动生成*使用方法
手动触发
# 默认：统计最新 commit
/ai-stats
# 统计暂存区
/ai-stats staged
# 统计指定 commit
/ai-stats commit abc1234
# 统计 commit 范围
/ai-stats range abc1234..def5678
# 指定需求名和用户名
/ai-stats commit abc1234 "用户管理模块" aurorayang作为 pre-commit hook
可以在 .git/hooks/pre-commit 中添加：
#!/bin/bash
# 调用 AI 代码统计
echo "正在统计 AI 生成代码..."
node .lingma/skills/ai-code-stats/ai-code-stats.js staged直接运行脚本
# 最新 commit
node .lingma/skills/ai-code-stats/ai-code-stats.js
# 暂存区
node .lingma/skills/ai-code-stats/ai-code-stats.js staged
# 指定 commit
node .lingma/skills/ai-code-stats/ai-code-stats.js commit abc1234
# commit 范围
node .lingma/skills/ai-code-stats/ai-code-stats.js range abc1234..def5678
# 完整参数示例
node .lingma/skills/ai-code-stats/ai-code-stats.js commit abc1234 "用户管理模块" aurorayangAI 代码标记识别规则
1. 完整 AI 生成文件标记
/**
* @ai-generated
* @date 2024-01-15
* @description 用户管理模块
*/2. 部分 AI 生成代码标记
// @ai-generated-start
// 这部分代码由 AI 生成
function autoGenerated() {
// ...
}
// @ai-generated-end输出示例
控制台输出
🔍 AI 代码统计
================
统计人: zhangsan
需求名称: 用户管理模块 (命令行指定)
📋 模式: 指定 Commit 检查 (abc1234)
变更文件: 5 个
新增行数: 320 行
删除行数: 45 行
🤖 AI 生成统计
================
AI 生成文件: 2 个
AI 生成行数: 180 行
AI 代码占比: 56.3%
📄 报告已生成
================
模式: 新建报告
路径: AI-Generate/zhangsan/ai-code-report-2024-01-15-用户管理模块.md报告存储结构
{project-root}/
└── AI-Generate/
├── zhangsan/
│ ├── ai-code-report-2024-01-15-143022.md
│ ├── ai-code-report-2024-01-16-092145.md
│ └── summary.md (累计统计)
├── lisi/
│ └── ai-code-report-2024-01-15-161530.md
└── ...技术实现
使用的 Git 命令
最新 Commit 模式
git show --numstat --format= HEAD
git show HEAD -- "{file}"暂存区模式
git diff --cached --numstat
git diff --cached -- "{file}"指定 Commit 模式
git show --numstat --format= {hash}
git show {hash} -- "{file}"Commit 范围模式
git diff --numstat {hash1}..{hash2}
git diff {hash1}..{hash2} -- "{file}"通用命令
# 获取当前用户名
git config user.name
# 获取即将提交的 commit 信息
git log -1 --pretty=format:%s HEAD
# 获取暂存区 tree hash
git write-tree文件检测逻辑
- 根据模式选择对应的 Git 命令获取变更
- 读取每个变更文件的内容
- 检查文件头部是否包含
@ai-generated标记 - 扫描文件内容中的
@ai-generated-start和@ai-generated-end标记对 - 计算标记范围内的代码行数
- 累加得到 AI 生成代码总行数
配置选项
支持的文件类型
.ts- TypeScript.tsx- TypeScript React.js- JavaScript.jsx- JavaScript React.mpx- MPX 小程序框架.vue- Vue 单文件组件.less/.scss/.css- 样式文件.json- JSON 文件.md- Markdown 文件
排除路径
以下路径的文件会被自动排除：
node_modules/dist/build/.git/.lingma/AI-Generate/（避免自引用）
注意事项
- 模式选择：
- staged 模式检查暂存区内容，适合 pre-commit 场景 - commit 模式检查已提交的特定 commit - range 模式适合统计一个功能分支的所有变更
- 确保 Git 配置正确：需要正确设置
user.name才能生成个人报告 - 标记必须规范：AI 生成代码需要按照规范添加标记才能被正确识别
- 报告不会自动提交：生成的报告文件需要手动添加到暂存区
- 重复统计防护：
- 相同 commit hash 不会重复生成报告 - 相同文件内容（blob hash）不会重复统计
版本历史
v1.2.0
- 新增子命令支持：
staged、commit、range - 支持统计指定 commit 的代码
- 支持统计 commit 范围的代码
- 优化参数解析逻辑，兼容旧用法
v1.1.0
- 新增用户名参数支持
- 支持
/ai-stats [task-name] [username]格式 - 不传参数时默认使用 Git 用户名
v1.0.0
- 初始版本
- 支持暂存区 AI 代码统计
- 生成个人专属报告
- 支持历史累计统计