القائمة
陕交控项目专用 Git 操作管理 - 规范化的提交、分支管理、GitHub 协作流程，包含常用 Git 操作命令模板和最佳实践
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
陕交控项目专用路网路径查询工具 - 提供相邻节点查询、最短路径、Top N 替代路径、排除节点查询等功能，支持递归 CTE 和 pgRouting 两种实现方式
陕交控项目专用 pgRouting 路网优化工具 - 基于 PostgreSQL + PostGIS + pgRouting 构建高速路网拓扑，支持最短路径、Top N 路径、排除节点查询等高性能路径分析功能
陕交控项目专用数据导入工具 - 处理收费单元路径、收费站信息、收费路段等基础数据的Excel/CSV多版本导入，严格遵循数据字典，自动生成建表语句和导入脚本
陕交控项目专用文档更新工具 - 自动更新会话记录、业务逻辑记录、表口径总表等项目文档，保持文档与代码同步
陕交控项目批量处理并行化工具 - 将单进程 ETL/统计任务改造为多进程并行模式，含 CSV 分区读取、fork-safe DB、ON CONFLICT 累加、mini-batch 即时刷盘等完整模式
陕交控项目专用SQL生成工具 - 按照项目规范生成DDL/DML/SQL检查语句，支持数据仓库分层（DIM/DWD/DWS/ADS），自动添加中文注释和版本字段
| name | shanxi-resilience-git |
| description | 陕交控项目专用 Git 操作管理 - 规范化的提交、分支管理、GitHub 协作流程，包含常用 Git 操作命令模板和最佳实践 |
仓库地址: https://github.com/sunhaoyu-1990/shanxi_resilience_enhancement.git
分支策略: main 为主分支，所有开发在 main 上进行
主要开发者: sunhaoyu
git clone https://github.com/sunhaoyu-1990/shanxi_resilience_enhancement.git
cd shanxi_resilience_enhancement
uv sync # 重建虚拟环境
# 1. 查看当前状态
git status
# 2. 添加文件（按模块添加，不使用 git add -A）
git add src/modules/m1_xxx/
git add sql/dml/m1/
git add docs/
# 3. 提交（使用约定格式）
git commit -m "feat(m1): 补充收费单元通行能力计算"
# 4. 推送（首次推送加 -u）
git push
# 查看工作区变更
git status -s
# 查看文件差异
git diff src/modules/m1/service.py
# 查看提交历史
git log --oneline -10
# 查看某次提交的所有变更
git show HEAD --stat
<type>(<scope>): <description>
[optional body]
| Type | 说明 | 适用场景 |
|---|---|---|
feat | 新功能 | 新增模块功能 |
fix | Bug 修复 | 修复已知问题 |
refactor | 重构 | 代码优化 |
docs | 文档 | 文档更新 |
test | 测试 | 测试用例 |
chore | 构建/工具 | 工具链变更 |
perf | 性能 | 性能优化 |
ci | CI/CD | CI 配置 |
m0 ~ m6: 对应模块sql: SQL 文件变更docs: 文档变更scripts: 脚本变更configs: 配置变更feat(m1): 补充收费单元通行能力计算
fix(m2): 修复流量统计空值处理
docs: 更新数据表说明文档
chore: 添加 .gitignore 配置
refactor(sql): 重构 M3 交通影响分析 SQL
git push --forcegit add . 或 git add -A.env + .env.example.gitignore 排除# 设置用户名和邮箱（项目级别）
git config user.name "sunhaoyu"
git config user.email "sunhaoyu@163.com"
# 设置默认分支
git branch -M main
# 检查远程仓库
git remote -v
git fetch origin
git pull origin main
.venv/ # 虚拟环境（~150MB）
uv.lock # 自动生成
outputs/*.csv # 数据导出文件
outputs/logs/*.log # 日志文件
research/data/*.pptx # 大型 PPT
research/data/*.pdf # 大型 PDF
*.log # 所有日志文件
*.tmp # 临时文件
# 检查将要提交的文件大小
git status -s
# 检查是否有大文件
git ls-files | xargs -I{} du -h "{}" 2>/dev/null | sort -h | tail -10
git checkout -- src/modules/m1/service.py
git reset HEAD src/modules/m1/service.py
# 添加遗漏的文件
git add missed_file.py
git commit --amend --no-edit
# 修改提交信息
git commit --amend -m "新的提交信息"
git reset --soft HEAD~1
由于是单人开发，采用简化模式：
main (受保护)
└── 所有开发直接在 main 进行
git status 确认变更文件.gitignore 已排除常见敏感文件.env 不在版本控制中settings.local.json 不在版本控制中# 设置别名（可选）
git config --global alias.st "status -s"
git config --global alias.lg "log --oneline -10"
git config --global alias.co "checkout"
git config --global alias.cb "checkout -b"
# 查看状态
git status
# 添加变更（按模块）
git add src/ sql/ docs/
# 提交
git commit -m "feat(module): description"
# 推送
git push
# 查看历史
git log --oneline -5