dualface/easy-codex

dualface のプロフィール

記録された最新のソース活動: 2026年6月1日 12:24

SkillsMP カタログ更新: 2026年10月17日 00:09

収集済み skills: 6

GitHub スター: 4
GitHub フォーク: 0

リポジトリの README

README の元ファイル：README.md

README の元ファイルを読む

README 全文を表示

# Easy Codex Easy Codex 是一组面向仓库任务的 Codex 技能。它把模糊需求拆成规格、计划、执行、审查和交付几个阶段，并用 git worktree 隔离实现过程，降低误改 main worktree 和跨阶段漏审的风险。适合这些任务： - 需求不够清楚，需要先写规格和验收标准 - 改动跨多文件、接口、数据流或测试 - 希望按阶段实现、验证、提交 - 希望实现后做计划审查或代码最终审查 - 需要交付摘要、验证记录、提交信息或 PR 说明不适合这些任务： - 简单问答或一次性小修 - 不希望使用 worktree 的临时改动 - 不允许子代理参与规格、计划或实现审查的流程 ## 技能列表 | 技能 | 用途 | | --- | --- | | `$using-easy-codex` | 入口路由。根据当前请求选择最合适的 Easy Codex 技能。 | | `$easy-codex-spec` | 创建或选择 worktree，澄清需求，写 `docs/specs/` 规格。 | | `$easy-codex-writing-plans` | 把已批准规格拆成 `docs/plans/` 阶段实现计划。 | | `$easy-codex-executing-plans` | 用子代理按已批准计划实现、审查、验证并按阶段提交。 | | `$easy-codex-review` | 审查计划或代码改动，代码最终审查写入 `docs/reviews/`。 | | `$easy-codex-ship` | 在最终审查通过或风险被接受后准备交付总结和 PR 说明。 | ## 安装推荐在 Codex 中用 `$skill-installer` 安装。给它这个仓库地址或本仓库路径，让它安装 Easy Codex 技能包。 ```text $skill-installer https://github.com/dualface/easy-code ``` 安装或更新后，重启 Codex，让新技能重新加载。本仓库开发时，也可以在仓库根目录执行： ```bash ./scripts/install.sh ``` 安装脚本会： - 先运行 `npm run validate` - 把 `skills/*` 复制到 `~/.codex/skills/easy-codex--<技能名>` - 删除已安装但源码中不存在的旧 Easy Codex 技能从 git 拉取更新并重新安装： ```bash ./scripts/install.sh --update ``` 更新后同样需要重启 Codex。卸载： ```bash ./scripts/uninstall.sh ``` 手动校验： ```bash npm run validate ``` ## 使用在 Codex 中从入口技能开始： ```text $using-easy-codex ``` 也可以直接调用具体阶段： ```text $easy-codex-spec $easy-codex-writing-plans $easy-codex-executing-plans $easy-codex-review $easy-codex-ship ``` 典型流程： 1. `$easy-codex-spec` 写规格，用户批准后进入计划。 2. `$easy-codex-writing-plans` 写阶段计划，计划审核通过或风险被接受后进入执行。 3. `$easy-codex-executing-plans` 按阶段实现、审查、验证、提交。 4. `$easy-codex-review` 做代码最终审查，写 `docs/reviews/` 记录。 5. `$easy-codex-ship` 输出交付摘要、验证记录和 PR 说明。 ## Worktree 规则从规格阶段开始，Easy Codex 必须使用 git worktree： - worktree 必须位于主项目根目录的 `worktrees/<name>` - main worktree 只允许创建 `worktrees/` 和管理 worktree，不写项目文件 - 规格和计划必须记录 `主项目根`、`绝对 worktree 路径`、`显示路径` 和 `基准` - `绝对 worktree 路径` 必须等于 `<主项目根>/<显示路径>` 的 `realpath` 结果，且不能指向 main worktree - 计划执行必须在计划记录的 worktree 内进行 - 每个实现阶段验证通过后必须提交一次这些规则是硬门禁。字段缺失、路径不合法、基准缺失或流程状态不满足时，技能会停止并返回上一个阶段补齐。 ## 文档产物 Easy Codex 默认写这些文件： - `docs/specs/YYYY-MM-DD-<slug>.md`：规格、目标、非目标、范围、验收标准、验证计划、风险 - `docs/plans/YYYY-MM-DD-<slug>.md`：阶段计划、执行拓扑、写集、验证命令、回滚说明 - `docs/reviews/YYYY-MM-DD-<slug>.md`：代码最终审查结论、基准、HEAD、风险接受记录、验证缺口规格和计划文档带流程状态字段： - 规格或计划状态 - 用户批准记录 - 审核状态 - 下一阶段许可没有这些状态，后续阶段不会继续。 ## 子代理默认配置 `$easy-codex-executing-plans` 按阶段类型指定默认 `model` 和 `reasoning_effort`： | 阶段类型 | 默认模型 | 默认 effort | | --- | --- | --- | | 机械实现，1-2 文件、阶段清楚 | `gpt-5.4-mini` | `medium` | | 常规实现，多文件但边界清楚 | `gpt-5.5` | `medium` | | 复杂实现、调试、迁移、跨模块契约 | `gpt-5.5` | `high` | | 规格符合审查 | `gpt-5.5` | `high` | | 代码质量审查 | `gpt-5.5` | `high` | | 高风险安全、数据、架构审查 | `gpt-5.5` | `xhigh` | 默认不指定 `service_tier`。用户要求覆盖时，技能会提供默认、提高能力、降低成本或自定义 model/effort 的选择。 ## 审查和交付门禁 - 规格和计划必须经过子代理审核。 - 实现阶段先做规格符合审查，再做代码质量审查。 - 任一审查有开放问题，禁止进入下一阶段。 - 代码最终审查必须写入 `docs/reviews/`。 - `$easy-codex-ship` 只在代码最终审查通过，或用户接受代码审查剩余风险后使用。 - 计划审查通过或接受计划风险，不能直接交付。 ## 仓库开发修改技能后运行： ```bash npm run validate ``` 重新安装本地技能： ```bash ./scripts/install.sh ``` 发布前建议检查： ```bash git status --short npm run validate ``` ## 目录结构 ```text . ├── easy-codex.manifest.json ├── package.json ├── scripts/ │ ├── install.sh │ ├── uninstall.sh │ └── validate-skill-pack.mjs └── skills/ ├── executing-plans/ ├── review/ ├── ship/ ├── spec/ ├── using-easy-codex/ └── writing-plans/ ```

リポジトリの README を読み込んでいます…

このリポジトリの skills

ソフトウェア開発者ソフトウェア品質保証アナリスト・テスタープロジェクト管理専門家

3 件の職業カテゴリ · 100% 分類済み

skill

職業分類

説明

更新

easy-codex-executing-plans

ソフトウェア開発者

当已有经用户批准且审核通过或剩余风险已被接受的实现计划，需要用子代理逐阶段执行实现、做规格符合审查和代码质量审查时使用。

原文の言語: 中国語

2026-06-01

easy-codex-review

ソフトウェア品質保証アナリスト・テスター

当用户要求审查计划、本地改动、执行计划后的代码最终审查、拉取请求风格审查、回归风险检查或验证缺口分析时使用。

原文の言語: 中国語

2026-06-01

easy-codex-ship

ソフトウェア開発者

当本地改动已通过代码最终审查或用户已接受代码审查剩余风险，需要准备交付总结、验证记录、提交信息、提交操作或拉取请求说明时使用。

原文の言語: 中国語

2026-06-01

easy-codex-spec

プロジェクト管理専門家

当用户希望在实现前澄清需求、编写规格说明、设计说明或需求文档，定义范围、非目标、验收标准、验证计划和风险，或任务模糊且直接实现容易跑偏时使用。

原文の言語: 中国語

2026-06-01

using-easy-codex

ソフトウェア開発者

当用户明确要求使用 easy-codex、希望此技能包路由仓库任务，或询问哪个 easy-codex 技能适合时使用。

原文の言語: 中国語

2026-06-01

easy-codex-writing-plans

ソフトウェア開発者

当已有经用户批准的规格说明，需要在实现前编写分阶段实现计划、阶段拆解、文件影响、测试计划和执行交接文档时使用。

原文の言語: 中国語

2026-06-01

収集済み skill 6 件中 6 件を表示しています。

AI アシスタントでインストール

このプロンプトをコピーして、使用中の AI アシスタントに送ってください。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/dualface/easy-codex.