Skills 项目说明

这是一个用于存放 Codex Skills 的仓库。每个 Skill 都是一个独立目录，包含最少一个 SKILL.md，并可按需附带脚本、参考文档和界面元数据。

GitHub 仓库地址：https://github.com/GodD6366/skills

当前目录结构

skills/
├── README.md
├── s3-upload/
│   ├── SKILL.md
│   ├── agents/
│   │   └── openai.yaml
│   ├── references/
│   │   └── configuration.md
│   └── scripts/
│       └── upload_s3.py
└── use-subagent/
    ├── SKILL.md
    ├── agents/
    │   └── openai.yaml
    ├── references/
    │   └── prompts.md
    └── scripts/
        └── init_agents.py

项目目标

• 统一管理可复用的 Codex Skills
• 为特定任务提供稳定、可复用的流程说明
• 通过脚本、参考资料和资源文件减少重复劳动
• 让 Skill 文档、结构和触发描述保持清晰一致

Skill 目录约定

每个 Skill 目录通常包含：

• SKILL.md：Skill 的核心说明文档，包含 frontmatter 与使用指引
• agents/openai.yaml：界面展示元数据，例如显示名、简短说明、默认提示词
• scripts/：可执行脚本，用���稳定完成重复性任务
• references/：按需读取的详细参考资料
• assets/：输出时需要使用但不必直接加载进上下文的资源文件

给 Agent 的安装提示词

下面每个 Skill 都附带一段可直接复制的提示词，方便你粘贴给 agent，让它从 GitHub 读取对应 Skill。

s3-upload

用途：把本地文件上传到 AWS S3、MinIO 或其他兼容 S3 的对象存储。

可复制提示词：

请安装并接入这个 GitHub 上的 Skill：`s3-upload`

Skill 目录：
https://github.com/GodD6366/skills/tree/main/s3-upload

use-subagent

用途：把“先定位、再规划、最后亲自改代码”的主代理调度规则沉淀成可复用 Skill。

可复制提示词：

请安装并接入这个 GitHub 上的 Skill：`use-subagent`

Skill 目录：
https://github.com/GodD6366/skills/tree/main/use-subagent

当前 Skill：s3-upload

GitHub 目录：https://github.com/GodD6366/skills/tree/main/s3-upload

支持能力包括：

• 上传单个或多个本地文件
• 指定对象 key 或批量上传前缀 prefix
• 使用自定义 endpoint
• 支持 path-style / virtual-hosted-style
• 设置 metadata、ACL、content type、cache control
• 通过 Python 标准库实现确定性上传

当前 Skill：use-subagent

GitHub 目录：https://github.com/GodD6366/skills/tree/main/use-subagent

支持能力包括：

• 初始化完整子 agent 小队：explorer、planner、worker、verifier、reviewer、fixer
• 为每个子 agent 分别配置模型 ID，写入 ~/.codex/agents/*.toml
• 未知代码位置时，强制先走 explorer 定位
• 已知位置但方案不明时，强制先走 planner 定方案
• 方案明确后，由主代理亲自执行最小改动
• 约束输出为极简路由提示，避免长篇“思考清单”
• 控制子代理上下文，减少噪音和副作用

初始化命令：

python3 "$CLAUDE_SKILL_DIR/scripts/init_agents.py"

开发与维护建议

• 修改 Skill 后，优先保持 SKILL.md 与 agents/openai.yaml 一致
• 尽量把详细配置和长篇示例放入 references/
• 尽量把重复性操作沉淀为 scripts/
• 新增 Skill 时，同步在本 README 里补一段“给 Agent 的安装提示词”
• 给 Agent 的提示词优先使用 GitHub raw 或 tree 链接，不要使用本地绝对路径
• 不要在单个 Skill 目录里添加与执行无关的额外说明文件，避免噪音

校验

可使用 Skill Creator 提供的校验脚本检查 Skill 基本格式是否正确：

python3 /Users/godd/.codex/skills/.system/skill-creator/scripts/quick_validate.py \
  /Users/godd/workspace/skills/s3-upload