Task Skills

面向具体应用、设备和工作流程的 Agent Skills 插件，可安装到支持插件的 ChatGPT 桌面端 Work 和 Codex。每个 Skill 说明何时使用、怎样完成任务，以及如何核对结果。

这里收录基金持仓读取、macOS 日常维护等具体任务；项目配置、Agent 行为改进和仓库维护继续放在 agent-toolbox。按实际需要增加 Skill，不预先搭建分类框架。

已有 Skill

安装插件

仓库使用 Agent Plugins 1.0 格式：根目录 plugin.json 定义插件，skills/ 中的技能随插件一起安装。仓库内的 .agents/plugins/marketplace.json 提供安装目录。

通过支持插件命令的 Codex CLI 从 GitHub 安装：

codex plugin marketplace add https://github.com/chenkeyv/task-skills.git --ref main
codex plugin add task-skills@task-skills
codex plugin list --json

在 ChatGPT 桌面端 Work 的插件页面中，也可从已配置的 Task Skills 来源安装。若安装后尚未出现，重新打开应用并创建新任务。安装到已有的 Personal 来源时，可把本仓库安装目录中的插件条目合并进 ~/.agents/plugins/marketplace.json 的 plugins 数组，保留已有条目，然后使用 codex plugin add task-skills@personal；两种来源选择一种即可。

插件安装不会自动安装 Python 或 ADB，也不会自动授予手机权限。基金持仓读取需要任务执行环境能访问连接手机的电脑；仅在网页或云端安装插件不会获得本机 USB 访问能力。

单独安装 Skill

将需要的 skills/<name>/ 安装到所用客户端的用户级 Skill 目录。Codex 的默认位置是 ~/.codex/skills/，自定义 CODEX_HOME 时使用其下的 skills/。安装前检查是否已有同名 Skill，避免覆盖本地修改。

使用

安装插件后可以直接请求：

用 Task Skills 读取我连接的 Android 手机上的基金 e 账户持仓，并核对总额。

一条查询命令从息屏或系统桌面开始，自动唤醒解锁、打开基金 e 账户、等待启动、回到首页，再进入持仓，保存结果后让应用退到后台，再自动息屏并返回结果。已识别的只读查询提示会按内容和控件检查后处理；固定的运行环境提示在确认后保留到结果警告中。随后使用结构化文字读取：首次返回完整明细，后续只报告日期、金额及产品变化；异常时才截图。成功结果保存为任务本地基线，失败不会覆盖基线。误触进入其他页面时，可请求“恢复基金 e 账户首页”；恢复功能只导航，不改写持仓基线。

执行持仓读取或首页恢复前会自动唤醒手机，并请求系统解除无密码锁屏；确认解锁后才继续。全流程输出各阶段状态，某一步失败不会报告查询完成。需要身份验证时停止，交由用户在手机完成，不更改锁屏设置。

Mac 维护可请求：“检查 Mac 的磁盘空间、系统状态和可用更新，先不清理或安装。”清理和安装更新按照明确授权范围执行；扫描不代表已经释放空间，下载更新不代表已经安装生效。

具体依赖、权限和操作边界见各 Skill 的 SKILL.md。仓库保存可复用流程，任务截图、账户数据和导出结果留在执行任务的工作目录。

增加和维护 Skill

在 skills/<skill-name>/SKILL.md 中写明名称、触发场景和必要流程。需要重复执行的逻辑放在同目录的 scripts/，条件性资料放在 references/。出现多个实际使用场景后再提炼共享能力。

修改已发布的插件内容时递增 plugin.json 的版本，便于客户端更新缓存。新增 Skill 时更新上方目录；涉及脚本行为时补充有意义的离线测试。设备或外部服务验证应注明测试范围和日期，使用模拟数据编写测试，不提交真实任务记录。

验证

运行脚本的依赖见各 Skill。仓库的离线检查另外需要 PyYAML：

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
.venv/bin/python -m unittest discover -s tests -v

检查覆盖插件元数据、ADB 权限错误、持仓解析、增量比较、金额核对、导航失败及异常截图处理，不连接手机，也不调用外部服务。真机检查需在相应任务已获授权时另行执行。