Codex Workflow Skills

面向研究、设计与开发任务的可靠 Codex 工作流

English · 简体中文

这组 Skills 为 Codex 提供可复用的端到端流程：明确目标、选择工具、验证证据、处理不确定性， 并交付可以直接执行或继续迭代的结果。每个 Skill 都针对真实工作场景设计，而不是一组孤立提示词。

安装

安装单个 Skill

只需要其中一个功能时，推荐使用 Codex 内置的 $skill-installer。在 Codex 对话中输入：

使用 $skill-installer 安装：
https://github.com/ETOLucy/codex-workflow-skills/tree/main/plugins/etolucy-skills/skills/general-web-research

将最后的目录名替换为需要的 Skill：

Skill	GitHub 安装地址
create-context-aware-logos	安装地址
find-open-source-solutions	安装地址
general-web-research	安装地址
learn-by-building	安装地址
manage-github-repository	安装地址

安装完成后开启一个新对话。单 Skill 安装的是当前版本快照；需要更新时，重新安装该 Skill。 find-open-source-solutions 声明了只读 GitHub MCP 和 Context7 MCP，安装时可能需要授权。

安装完整合集

需要全部 Skills、插件品牌和 MCP 配置时，将此 GitHub 仓库添加为 Codex 第三方插件源：

codex.cmd plugin marketplace add ETOLucy/codex-workflow-skills

macOS 或 Linux：

codex plugin marketplace add ETOLucy/codex-workflow-skills

然后在 Codex 应用的 Marketplace 中安装 etolucy-skills 并开启新对话。此操作只是将本仓库 登记为用户自己的第三方插件源，不会把项目发布到 OpenAI 官方公开 Marketplace。

安装方式	适用情况
单 Skill 安装	只需要一个功能，安装最轻量
完整插件合集	需要全部 Skills、统一品牌和 MCP 配置

Skill 一览

Skill	用途	适用场景
create-context-aware-logos	根据目标平台设计原创 Logo，并交付可直接使用的资产组合	GitHub 仓库、应用图标、CLI、网站品牌、Codex Skill/插件
general-web-research	将开放问题转化为可追溯证据和面向决策的尽调报告	人物、组织、产品、市场、声誉、职业选择和其他时效性课题
find-open-source-solutions	发现、核验并比较 GitHub 项目，给出明确的单仓库或组合方案	技术选型、开源替代品、项目基础和多仓库方案设计
learn-by-building	在交付可运行项目的同时讲清思路，建立可迁移的开发能力	项目创建、功能开发、调试、重构、代码理解和结对式学习
manage-github-repository	同步管理本地与远程仓库名称、GitHub 元数据、品牌资产和 README	仓库改名、description、homepage、topics、social preview 与 README 整理

Context-Aware Logo Design

默认从三个真正不同的方向开始，再精修选定方案。它会根据目标场景自动选择 SVG、深浅色版本、 README 字标、Social Preview 或应用图标等交付物，并检查小尺寸识别、无障碍信息和文件安全。

示例：为我的 GitHub 仓库设计一个简洁 Logo，并交付 README 标志和 Social Preview。

General Web Research

先定义决策、范围和证据标准，再检索官方来源、独立报道、论坛和公开数据。输出会区分事实、 他人陈述、推断与未知项，并保留日期、冲突、风险和可审计来源。

示例：调查这家公司是否适合作为长期供应商，重点核查经营稳定性、公开争议和交付风险。

Find Open Source Solutions

使用只读 GitHub MCP 发现并核验候选，通过 Context7 阅读代码和官方文档，比较维护状态、架构、 集成成本与生态成熟度，最后给出一个默认推荐和有条件的替代方案。

示例：为内部知识库推荐可自托管方案，需要权限控制、全文检索和中文支持。

Learn by Building

把实现拆成可运行、可验证的小步，在关键决策处解释原理和权衡，维护中英文项目文档， 并在任何 GitHub 发布操作前请求确认。

示例：帮我做一个 React 记账应用；每完成一个模块，解释数据流和设计选择。

设计原则

• 面向结果： 从用户要做的决策或交付物出发，而不是从工具列表出发。
• 证据优先： 对会变化或影响决策的事实进行实时核验。
• 渐进披露： 只在需要时加载详细参考资料，控制上下文成本。
• 安全默认： 不包含密钥、个人数据、本机路径或私有服务配置。
• 确认后发布： 涉及外部写入或 GitHub 发布时保留明确的用户确认边界。

工具与权限

• create-context-aware-logos 默认使用本地 SVG 和校验工具；插画型需求才需要图片生成能力。
• general-web-research 使用当前环境可用的网页搜索和浏览工具。
• find-open-source-solutions 配置只读 GitHub MCP 和 Context7 MCP；GitHub MCP 安装时请求认证。
• learn-by-building 使用当前项目的开发工具，并在发布前请求确认。
• manage-github-repository 使用 GitHub CLI 完成受支持的远程操作，并调用 create-context-aware-logos 设计仓库视觉资产。

仓库结构

.agents/plugins/marketplace.json
assets/brand/
plugins/etolucy-skills/
├── .codex-plugin/plugin.json
├── .mcp.json
├── assets/
└── skills/
    ├── create-context-aware-logos/
    ├── find-open-source-solutions/
    ├── general-web-research/
    ├── learn-by-building/
    └── manage-github-repository/

支持与维护

遇到问题或希望提出改进，请使用 GitHub Issues。 项目由 ETOLucy 维护。

License

MIT