메뉴
陕交控项目专用文档更新工具 - 自动更新会话记录、业务逻辑记录、表口径总表等项目文档，保持文档与代码同步
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
陕交控项目专用路网路径查询工具 - 提供相邻节点查询、最短路径、Top N 替代路径、排除节点查询等功能，支持递归 CTE 和 pgRouting 两种实现方式
陕交控项目专用 pgRouting 路网优化工具 - 基于 PostgreSQL + PostGIS + pgRouting 构建高速路网拓扑，支持最短路径、Top N 路径、排除节点查询等高性能路径分析功能
陕交控项目专用数据导入工具 - 处理收费单元路径、收费站信息、收费路段等基础数据的Excel/CSV多版本导入，严格遵循数据字典，自动生成建表语句和导入脚本
陕交控项目专用 Git 操作管理 - 规范化的提交、分支管理、GitHub 协作流程，包含常用 Git 操作命令模板和最佳实践
陕交控项目批量处理并行化工具 - 将单进程 ETL/统计任务改造为多进程并行模式，含 CSV 分区读取、fork-safe DB、ON CONFLICT 累加、mini-batch 即时刷盘等完整模式
陕交控项目专用SQL生成工具 - 按照项目规范生成DDL/DML/SQL检查语句，支持数据仓库分层（DIM/DWD/DWS/ADS），自动添加中文注释和版本字段
SOC 직업 분류 기준
| name | shanxi-resilience-doc-updater |
| description | 陕交控项目专用文档更新工具 - 自动更新会话记录、业务逻辑记录、表口径总表等项目文档，保持文档与代码同步 |
专门用于陕交控多路段改扩建韧性提升项目的文档维护工作。
自动更新 docs/会话记录与搭建过程.md：
维护 docs/业务逻辑记录.md：
更新表口径总表：
更新 .Codex/memory/MEMORY.md：
## 第{N}阶段：{阶段名称}
### 第{N}步：{步骤名称}
**用户请求**:
> "{用户原文}"
**我的响应**:
- {响应内容}
---
### 实现结果
#### 1. 创建的文件
| 文件 | 说明 |
|------|------|
| {path} | {description} |
#### 2. 数据导入结果
| 统计项 | 数值 |
|--------|------|
| {key} | {value} |
---
### 最终项目状态
### ✅ 已完成的工作清单
- [x] {task1}
- [x] {task2}
### 📋 待完成工作（下一步）
- [ ] {task1}
- [ ] {task2}
---
## BL-00{x}: {业务逻辑名称}
**创建日期**: 2026-04-13
**相关模块**: M{N}
**相关表**: {table1}, {table2}
### 业务描述
{详细描述业务逻辑的用途和背景}
### 处理逻辑
1. {步骤1}
2. {步骤2}
3. {步骤3}
### 伪代码
```python
def {function_name}({params}):
{implementation}
-- {SQL描述}
SELECT {columns}
FROM {table}
WHERE {conditions};
| 字段名 | 说明 |
|---|---|
| {field} | {description} |
### 表口径登记结构
| 属性 | 值 |
|---|---|
| 表用途 | {description} |
| 粒度 | {grain} |
| 主键 | {pk} |
| 来源 | {source} |
| 下游使用模块 | {modules} |
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| {field} | {type} | {description} |
## 使用示例
### 更新会话记录
```bash
skill: shanxi-resilience-doc-updater
args: "session --stage '收费路段数据导入' --step '数据分析与导入'"
skill: shanxi-resilience-doc-updater
args: "business-logic --name '判断是否交控集团' --module M0"
skill: shanxi-resilience-doc-updater
args: "table-registry --table dim_toll_road --layer dim"
skill: shanxi-resilience-doc-updater
args: "memory --status '完成收费路段数据导入'"
| 文档 | 路径 | 说明 |
|---|---|---|
| 数据表说明 | docs/数据表说明.md | ⭐ 所有表的权威说明文档，含连接信息、数据字典、查询示例 |
| 会话记录 | docs/会话记录与搭建过程.md | 完整的会话和工作记录 |
| 业务逻辑记录 | docs/业务逻辑记录.md | 业务逻辑和算法说明 |
| 表口径总表 | docs/表口径总表.md | 所有表的口径登记 |
| 项目记忆 | .Codex/memory/MEMORY.md | 项目状态和关键信息 |
| 使用指南 | README_USE_GUIDE.md | 项目使用指南 |
新建表后必须同步更新 docs/数据表说明.md，具体步骤：
更新顶部日期（第3行 > 更新日期：YYYY-MM-DD）
更新表清单总览（按字母序插入新行）：
| [新表名](#N-新表名) | DIM/DWD/DWS/ADS | 简介 | 记录数 |
并将后续表的锚点编号依次 +1。
### N. 新表名
**简介**：...
**主键**：...
#### 数据字典
| 字段名 | 类型 | 可空 | 描述 |
|--------|------|------|------|
#### 查询示例
```sql
SELECT ...
4. **后续章节标题编号** 依次 +1。
## 自动更新触发点
### 数据导入后
- 更新会话记录
- 登记表口径
- 更新项目记忆
### 表结构变更后
- 更新表口径总表
- 更新字段字典
- 记录变更原因
### 业务逻辑实现后
- 添加业务逻辑记录
- 提供 SQL 示例
- 关联相关表
### 阶段完成后
- 更新会话记录
- 更新已完成工作清单
- 列出下一步任务