Compare commits

...

2 Commits

Author SHA1 Message Date
朱潮
6f665b4117 Merge branch 'master' into bot_manager 2026-03-02 10:37:49 +08:00
朱潮
55505c727a update managing-scripts 2026-03-02 10:37:32 +08:00

View File

@ -10,10 +10,10 @@ description: Manages shared scripts repository for reusable data analysis tools.
## Quick Start
编写数据分析脚本时的通用化流程:
1. 读取 `./scripts/README.md` 检查是否有可复用的现成脚本
1. 读取 `./executable_code/README.md` 检查是否有可复用的现成脚本
2. 如有合适脚本,优先复用
3. 如需编写新脚本,**设计通用化方案**而非解决单一问题
4. 保存到 `./scripts/` 并更新 README
4. 保存到 `./executable_code/` 并更新 README
## Instructions
@ -21,7 +21,7 @@ description: Manages shared scripts repository for reusable data analysis tools.
当用户请求任何数据处理/分析任务时:
1. 检查 `./scripts/README.md` 是否存在
1. 检查 `./executable_code/README.md` 是否存在
2. 查找可处理**此类问题**的脚本(非完全匹配即可)
3. 现有脚本可通过参数调整满足需求时,优先复用
4. 告知用户使用的是现成脚本
@ -103,9 +103,9 @@ transformations:
- ✅ `aggregate_data.py`、`convert_format.py`、`clean_dataset.py`
- ❌ `analyze_sales_2024.py`、`fix_import_error.py`
2. 保存到 `./scripts/` 文件夹
2. 保存到 `./executable_code/` 文件夹
3. 在 `./scripts/README.md` 添加说明,包含:
3. 在 `./executable_code/README.md` 添加说明,包含:
- **通用功能描述**(描述解决的问题类型,非具体业务)
- 使用方法(含所有参数说明)
- 输入/输出格式
@ -114,7 +114,7 @@ transformations:
### 修改现有脚本
修改 `./scripts/` 下的脚本时:
修改 `./executable_code/` 下的脚本时:
1. 保持/增强通用性,避免收缩为特定用途
2. 同步更新 README.md 文档
@ -129,10 +129,10 @@ transformations:
思考过程:
1. 这是一个"数据聚合"问题,属于通用模式
2. 检查 scripts/README.md 是否有聚合工具
2. 检查 ./executable_code/README.md 是否有聚合工具
3. 如没有,创建通用聚合脚本 aggregate_data.py
4. 支持参数:--input、--group-by、--agg-column、--method
5. 用户调用python scripts/aggregate_data.py \
5. 用户调用python ./executable_code/aggregate_data.py \
--input data.xlsx --group-by region --agg-column amount
```
@ -221,7 +221,7 @@ README 条目应说明:
## Directory Structure
```
./scripts/
./executable_code/
├── README.md # 脚本目录和使用说明(必须存在)
├── aggregate_data.py # 通用聚合工具
├── convert_format.py # 格式转换工具