Part 7C:進階資料夾結構

scripts / data / resources 的用法

Python 腳本 CSV / JSON 模板檔案

曾慶良(阿亮老師) | AI 協作簡報實戰工作坊

🐍 scripts/ 資料夾:Python 腳本

📌 用途

放置 Python 或 Shell 腳本,讓 AI 透過 run_command 執行複雜邏輯

🎯 適用場景

  • 資料處理(CSV、JSON 轉換)
  • API 呼叫(網路請求)
  • 檔案批次處理
  • 複雜計算或資料轉換

📄 SKILL.md 中如何呼叫

### Step 2: Search Data
Run the search script:
```bash
python scripts/search.py \
  --keyword "{{user_keyword}}"
```

The script will return matching
results from the data folder.

📄 search.py 範例

import argparse
import csv

parser = argparse.ArgumentParser()
parser.add_argument('--keyword')
args = parser.parse_args()

with open('data/styles.csv') as f:
    reader = csv.DictReader(f)
    for row in reader:
        if args.keyword in row['name']:
            print(row)

📊 data/ 資料夾:CSV / JSON 資料

📌 用途

存放 CSV、JSON 等資料檔,供 Python 腳本查詢使用

📄 CSV 資料範例 (styles.csv)

name,primary_color,font,description
modern,#3498db,Inter,現代簡約風格
classic,#2c3e50,Georgia,經典傳統風格
playful,#e74c3c,Comic Sans,活潑有趣風格
minimal,#333333,Helvetica,極簡設計風格

📄 JSON 設定範例 (config.json)

{
  "default_author": "Your Name",
  "default_license": "MIT",
  "templates": {
    "readme": "resources/readme.md",
    "gitignore": "resources/gitignore.txt"
  },
  "options": {
    "auto_git_init": true,
    "create_src_folder": true
  }
}
💡 好處:將資料與邏輯分離,方便維護與擴充。修改資料不需要改腳本!

📄 resources/ 資料夾:模板檔案

📌 用途

存放模板檔案(HTML、JSON、Markdown 等),AI 讀取後填入參數

🔖 模板變數格式

  • {{PROJECT_NAME}}
  • {{PROJECT_DESCRIPTION}}
  • {{AUTHOR_NAME}}
  • {{FIREBASE_CONFIG}}
AI 會讀取模板,把 {{變數}} 替換成使用者提供的值

📄 readme-template.md 範例

# {{PROJECT_NAME}}

{{PROJECT_DESCRIPTION}}

## 安裝

```bash
npm install
```

## 使用方式

```bash
npm start
```

## 作者

{{AUTHOR_NAME}}

## 授權

MIT License

📋 Part C 重點回顧

三種選用資料夾的用途

🐍 scripts/

  • 放 Python / Shell 腳本
  • 處理複雜邏輯與計算
  • API 呼叫、批次處理

📊 data/

  • 放 CSV / JSON 資料檔
  • 供腳本查詢使用
  • 資料與邏輯分離

📄 resources/

  • 放模板檔案
  • 使用 {{變數}} 格式
  • AI 讀取後自動替換參數
記住:這三個資料夾都是選用的!
只有 SKILL.md 是必要的。

🎉 Part C 完成!

你已經學會進階資料夾結構了

接下來進入實作練習,動手建立你的第一個 Skill!