Skip to content

Commit d45d8c7

Browse files
committed
doc: add readme
1 parent cbfc78b commit d45d8c7

File tree

2 files changed

+83
-4
lines changed

2 files changed

+83
-4
lines changed

README.md

+44-4
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,47 @@
1-
# Commit-Lint-AI
1+
English | [简体中文](./README_zh-CN.md)
22

3-
1. 将commit-msg文件复制到.git/hooks目录下
4-
2. 将main.exe文件复制到工程目录下,如果你想复制到其他目录下,请留意commit-msg中的路径。
3+
# Git Hooks Code Standards Checker
54

6-
完成以上两步操作即可开启ai commit message 检查。
5+
A Git Hooks-based automation tool designed to verify code submission standards before commits, ensuring team code quality and commit message consistency.
76

7+
# Usage
8+
9+
- Copy the commit-msg file to the .git/hooks directory
10+
- Copy the main.exe file to your project directory. If you want to copy it to another directory, please pay attention to the path in commit-msg
11+
12+
## Key Features
13+
14+
- Commit Message Format Validation
15+
- Automated Code Style Checking
16+
- Basic Code Quality Verification
17+
- Sensitive Information Leak Detection
18+
- Branch Naming Convention Enforcement
19+
20+
## Technical Highlights
21+
22+
- Built on Git Hooks mechanism, particularly pre-commit and commit-msg hooks
23+
- Zero intrusion implementation, easy to promote within teams
24+
- Configurable, supporting custom validation rules
25+
- Fail-fast mechanism for early issue detection
26+
27+
## Use Cases
28+
29+
- Standardize team code submission process
30+
- Prevent low-quality code commits
31+
- Ensure commit message standardization
32+
- Reduce code review workload
33+
34+
## Advantages
35+
36+
- Automated execution without manual intervention
37+
- Unified development standards across teams
38+
- Enhanced code quality
39+
- Reduced production issues
40+
41+
## Benefits
42+
43+
- Streamlines the development workflow
44+
- Maintains consistent coding standards
45+
- Improves team collaboration
46+
- Reduces technical debt
47+
- Speeds up code review process

README_zh-CN.md

+39
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
简体中文 | [English](./README.md)
2+
3+
# Git Hooks 代码规范检查工具
4+
5+
一个基于 Git Hooks 的自动化工具,用于在代码提交前进行规范性检查,确保团队代码质量和提交信息的一致性。
6+
7+
# 使用方式
8+
9+
- 将commit-msg文件复制到.git/hooks目录下
10+
- 将main.exe文件复制到工程目录下,如果你想复制到其他目录下,请留意commit-msg中的路径
11+
12+
## 主要功能
13+
14+
- 提交信息(Commit Message)格式检查
15+
- 代码风格(Code Style)自动检查
16+
- 代码质量(Code Quality)基础验证
17+
- 敏感信息泄露检测
18+
- 分支命名规范检查
19+
20+
## 技术特点
21+
22+
- 基于 Git Hooks 机制,特别是 pre-commit 和 commit-msg hooks
23+
- 零侵入性,易于在团队中推广使用
24+
- 可配置化,支持自定义检查规则
25+
- 快速失败机制,提早发现问题
26+
27+
## 使用场景
28+
29+
- 规范团队代码提交流程
30+
- 预防低质量代码提交
31+
- 确保代码提交信息的规范性
32+
- 减少代码审查的工作量
33+
34+
## 优势
35+
36+
- 自动化执行,无需人工干预
37+
- 统一团队开发规范
38+
- 提高代码质量
39+
- 减少线上问题

0 commit comments

Comments
 (0)