AI 工具安装指南 / CODEX

为 Codex 安装
Marketing Skills。

可以把整套中国市场工作流安装进 Codex 项目,也可以只安装当前任务需要的一个 Skill。本指南会把仓库安装命令与 Codex 官方 Skill 发现路径分开说明,方便检查和验证。

HOST
Codex
FORMAT
AGENT SKILLS
MODULES
10 个 SKILL
UPDATED
2026-08-09
01 / 安装前检查

先查看所有可用模块,不改变项目。

下面的命令让本仓库安装器列出兼容 Skill;它是仓库的分发方式,不是 Codex、Claude Code 或 Cursor 厂商提供的命令。先检查源码与稳定 slug,再决定安装十个模块或一个 Skill。

预览 / 尚未安装READY
npx skills add fffffrost/market-skills --list
02 / 安装技能包

在目标项目目录中运行安装器。

需要多条相连工作流时安装完整技能库;如果只想小范围试用,打开 Skill 详情页,使用带 --skill 的单模块命令。

安装 / 全部 10 个模块READY
npx skills add fffffrost/market-skills
改为选择一个 Skill
03 / 核对官方发现路径

确认文件落在当前 AI 工具会搜索的位置。

Codex 会从当前工作目录向上直到仓库根目录,搜索项目级 .agents/skills。用户级 Skill 放在 ~/.agents/skills;管理员还可以配置 /etc/codex/skills。

PROJECT

.agents/skills/<skill-name>/SKILL.md

项目 + 用户
USER

~/.agents/skills/<skill-name>/SKILL.md

项目 + 用户
ADMIN

/etc/codex/skills/<skill-name>/SKILL.md

项目 + 用户
路径与触发信息核对于 2026-08-09。产品官方文档: Codex
04 / 触发并确认

正式使用前,先证明当前 AI 工具能发现 Skill。

用当前工具的手动触发方式,要求它说明 Skill 名称、最低输入和第一步安全动作。能发现不等于已经获得权限;每个工具和连接器仍需单独检查。

  1. 01

    SKILLS MENU

    /skills

  2. 02

    DIRECT REFERENCE

    $skill-name

05 / 安全试跑

先用一个合成或公开的市场任务。

选择输入已知、输出可检查的小任务。目标是验证发现、引用、边界和交接,而不是立刻把保密工作交给新方法。

SOURCE

阅读 SKILL.md 与每个引用资料或脚本。

INPUT

只用公开或合成材料,不提供账号、密钥或客户文档。

OUTPUT

把结果与 Skill 声明的模板和边界逐项对照。

HUMAN

事实、审批、承诺和外部动作都保留明确负责人。

TEST PROMPT / SYNTHETIC INPUT请使用 research-competitors 处理一个合成的中国市场场景。研究前先列出要支持的决定、最低输入、证据类型和人工判断点。不要使用私有数据,也不要在没有来源时提出当前市场主张。
06 / 排错

按范围、结构、刷新、权限的顺序检查。

  1. 01
    Skill 不在项目搜索路径中

    把它放进当前工作目录或父目录至仓库根目录下的 .agents/skills,或用 ~/.agents/skills 作为用户级路径。

  2. 02
    目录多套了一层

    正确结构是 <skill-name>/SKILL.md。保留旁边的引用文件,不要再用额外目录包住整个 Skill。

  3. 03
    文件存在但列表里看不到

    重启 Codex,再用 /skills 检查,并核对 SKILL.md 中的 name 与 description。

  4. 04
    Skill 启动后无法完成任务

    检查引用文件与所需工具。Skill 提供方法,但不会自动获得文件、网络或连接器权限。

FAQ

安装常见问题

01可以只安装一个 Marketing Skill 吗?

可以。打开 Skill 详情页,运行包含 --skill 与稳定 slug 的命令。

02安装后会自动获得私有数据权限吗?

不会。访问取决于你使用的 AI 工具、已启用的连接器与权限,必须单独检查。

03Skill 应该放进仓库吗?

如果团队需要共同审查和版本管理这套方法,使用项目范围;只有经过个人审查并需要跨项目使用时,才放入用户范围。

04怎样更新技能库?

先检查上游变更,再重新运行安装器或替换目录,并重复发现验证与安全试跑。

相关 / 其他 AI 工具

方法可以迁移,但不同工具的发现方式不同。

可以比较其他工具的安装路径,或回到通用安装与信任指南。