dualface/easy-codex

Profil dualface

Dernière activité source enregistrée: 1 juin 2026 à 12:24

Catalogue SkillsMP mis à jour: 26 octobre 2026 à 11:37

skills collectés: 6

Étoiles GitHub: 4
Forks GitHub: 0

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

# 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/ ```

Chargement du README du dépôt…

Skills dans ce dépôt

Développeurs de logiciels Analystes en assurance qualité des logiciels et testeurs Spécialistes en gestion de projets

3 catégories métier · 100% classifié

skill

métier

description

mis à jour