data_query_skill

Data Query Skills

面向团队私有仓库分发的 4 个 ODPS 数据查询 Skill：

• odps-ad-risk-analysis
• odps-growth-fission-report
• odps-product-efficiency-report
• query-user-behavior-path

每个 Skill 都可以独立安装，运行时只读取当前使用者自己的环境变量，不依赖作者机器上的项目目录或凭证文件。

环境准备

python3 -m pip install -r requirements.txt

在仓库外配置以下环境变量：

export ODPS_ACCESS_ID='个人 Access ID'
export ODPS_ACCESS_SECRET='个人 Access Secret'
export ODPS_PROJECT='ODPS 项目名'
export ODPS_ENDPOINT='ODPS Endpoint'

可以复制 .env.example 到个人私有配置目录，例如 ~/.config/data-query-skills/odps.env，填写后执行：

chmod 600 ~/.config/data-query-skills/odps.env
source ~/.config/data-query-skills/odps.env

不要把填有真实值的配置文件复制回仓库。每位同事应使用自己的账号和最小权限凭证。

从私有 GitHub 仓库安装

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo <组织>/<仓库> \
  --path \
    skills/odps-ad-risk-analysis \
    skills/odps-growth-fission-report \
    skills/odps-product-efficiency-report \
    skills/query-user-behavior-path

私有仓库需要本机已有 Git 凭证，或者配置 GH_TOKEN。安装完成后，Skill 会在下一轮 Codex 对话中可用。

从其他私有 Git 服务安装

git clone <私有仓库地址> data-query-skills
mkdir -p ~/.codex/skills
cp -R data-query-skills/skills/* ~/.codex/skills/

安全边界

• Skill 和 Git 仓库不得包含 Access ID、Access Secret、临时 Token 或带 Token 的 LogView URL。
• scripts/odps_module.py 只打印 ODPS Instance ID，不打印 LogView URL。
• 查询生成的 CSV、Excel、日志和个人 .env 默认不提交。
• 表名、指标口径和风控规则仍属于内部资料，只应放在授权的私有仓库。