duaer-spec 0.7.0 → 0.8.0

package/ADOPT.md

@@ -32,13 +32,14 @@ npx duaer-spec init --here --ops
 npx duaer-spec update --method    # rare; usually omit
 ```
 
-Works with **Cursor** and **Claude Code** (both hosts installed by default).
+Works with **Cursor**, **Claude Code**, and **Codex** (all hosts installed by default).
 
 ## What you get
 
 - Autonomous job loop (ask → Brief → work → accept)  
 - Cursor: `.cursor/rules` + `.cursor/skills`  
 - Claude Code: `CLAUDE.md` + `.claude/rules` + `.claude/skills`  
+- Codex: `AGENTS.md` + `.agents/skills`  
 - `.duaer/handoff.json` + `duaer handoff` after worktree remove  
 - Agent ops: `main` / `develop` / `feat` / `fix` + `.worktree/`  
 

package/AGENTS.md

@@ -19,6 +19,21 @@ documentation unless the adopting project explicitly overrides.
 
 Follow the project's [baseline](docs/baseline.md) (or its local equivalent).
 
+## Autonomous job loop (all hosts)
+
+For product work (new behavior, fixes, refactors), **you** run Brief → work →
+accept. Do **not** ask the human to type slash commands, phase names, or CLI
+flags.
+
+1. Isolate: `feat|fix/<name>` + `.worktree/feat-<name>/` (or `fix-…`); never
+   reuse the Brief folder name as the worktree id.
+2. Follow the `duaer-do` skill under the host skill root:
+   - Codex: `.agents/skills/duaer-do/SKILL.md`
+   - Cursor: `.cursor/skills/duaer-do/SKILL.md`
+   - Claude Code: `.claude/skills/duaer-do/SKILL.md`
+3. Briefs live in `.duaer/specs/<nnn-slug>/`. Method notes: [`DUADER.md`](DUADER.md).
+4. One handoff line; never claim done unless `delivery.json` is `accepted`.
+
 ## GitHub Issue Handling
 
 When the user provides a GitHub issue URL (or an unambiguous issue number for

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.8.0 — 2026-09-15
+
+### Codex host
+
+- Mirror `duaer-*` skills to `.agents/skills/` (Codex discovery path)
+- `AGENTS.md` always-on section names the Codex / Cursor / Claude skill roots
+- Cursor and Claude Code installs unchanged
+
 ## 0.7.0 — 2026-09-15
 
 ### Claude Code host

package/CLAUDE.md

@@ -13,12 +13,13 @@ This repository uses **duaer-spec**: coding agents are digital employees.
 
 ## Layout
 
-| Host | Rules | Skills |
+| Host | Always-on | Skills |
 |---|---|---|
-| Claude Code | `.claude/rules/` | `.claude/skills/` |
 | Cursor | `.cursor/rules/` | `.cursor/skills/` |
+| Claude Code | `CLAUDE.md` + `.claude/rules/` | `.claude/skills/` |
+| Codex | `AGENTS.md` | `.agents/skills/` |
 
-Both are installed by `npx duaer-spec init --here` / `update`.
+Installed by `npx duaer-spec init --here` / `update`.
 
 ## Branches
 

package/DUADER.md

@@ -14,7 +14,7 @@ runs Brief → work → accept. Humans are not the operators of the phase machin
 
 ## Agent procedure (autonomous)
 
-Follow the `duaer-do` skill (`.cursor/skills/` or `.claude/skills/`) on every product ask — **without**
+Follow the `duaer-do` skill (`.cursor/skills/`, `.claude/skills/`, or `.agents/skills/`) on every product ask — **without**
 waiting for a slash invocation:
 
 1. Assign Brief + `active-job.json`  
@@ -40,6 +40,7 @@ Humans need not configure it for everyday use.
     spec.md | tasks.md | delivery.json
 .cursor/rules|skills/                  # Cursor host
 .claude/rules|skills/ + CLAUDE.md      # Claude Code host
+.agents/skills/ + AGENTS.md            # Codex host
 ```
 
 Worktree and Brief are different layers. Prefer

package/README.md

@@ -19,9 +19,9 @@ npx duaer-spec init --here
 npx duaer-spec update
 ```
 
-Then use **Cursor** or **Claude Code** as usual — describe what you want.
+Then use **Cursor**, **Claude Code**, or **Codex** — describe what you want.
 
-Install writes both `.cursor/` and `.claude/` (plus `CLAUDE.md`).
+Install writes `.cursor/`, `.claude/` (+ `CLAUDE.md`), and `.agents/skills/` (Codex).
 
 中文说明：[`README.zh-CN.md`](README.zh-CN.md)
 

package/README.zh-CN.md

@@ -2,9 +2,9 @@
 
 **Duaer** 把 AI 编程助手变成**数字员工**：你用自然语言提需求，它自己跑 Spec → 实现 → 验收；只有交接干净才算完成。
 
-你**不用**操作流程。装一次之后，在 **Cursor** 或 **Claude Code** 里说话即可。
+你**不用**操作流程。装一次之后，在 **Cursor**、**Claude Code** 或 **Codex** 里说话即可。
 
-`init` / `update` 会同时写入 `.cursor/` 与 `.claude/`（以及 `CLAUDE.md`）。
+`init` / `update` 会写入 `.cursor/`、`.claude/`（+ `CLAUDE.md`）、以及 Codex 的 `.agents/skills/`。
 
 ## 安装
 

package/bin/duaer.mjs

@@ -211,20 +211,25 @@ function installMethod(target, opts) {
 
   installCursorMethod(target, opts)
   installClaudeMethod(target, opts)
+  installCodexMethod(target, opts)
 
   copyPath(join(PKG_ROOT, 'DUADER.md'), join(target, 'DUADER.md'), opts)
   console.log('  DUADER.md')
   ensureWorktreeGitignore(target)
 }
 
-function installCursorMethod(target, opts) {
-  ensureDir(join(target, '.cursor', 'skills'))
+function mirrorDuaerSkills(target, skillsDir, opts, label) {
+  ensureDir(skillsDir)
   const skillsRoot = join(PKG_ROOT, '.cursor', 'skills')
   for (const name of readdirSync(skillsRoot)) {
     if (!name.startsWith('duaer-')) continue
-    copyPath(join(skillsRoot, name), join(target, '.cursor', 'skills', name), opts)
+    copyPath(join(skillsRoot, name), join(skillsDir, name), opts)
   }
-  console.log('  .cursor/skills/duaer-*')
+  console.log(`  ${label}`)
+}
+
+function installCursorMethod(target, opts) {
+  mirrorDuaerSkills(target, join(target, '.cursor', 'skills'), opts, '.cursor/skills/duaer-*')
 
   ensureDir(join(target, '.cursor', 'rules'))
   copyPath(
@@ -236,13 +241,12 @@ function installCursorMethod(target, opts) {
 }
 
 function installClaudeMethod(target, opts) {
-  ensureDir(join(target, '.claude', 'skills'))
-  const skillsRoot = join(PKG_ROOT, '.cursor', 'skills')
-  for (const name of readdirSync(skillsRoot)) {
-    if (!name.startsWith('duaer-')) continue
-    copyPath(join(skillsRoot, name), join(target, '.claude', 'skills', name), opts)
-  }
-  console.log('  .claude/skills/duaer-*  (mirrored from .cursor/skills)')
+  mirrorDuaerSkills(
+    target,
+    join(target, '.claude', 'skills'),
+    opts,
+    '.claude/skills/duaer-*  (mirrored from .cursor/skills)',
+  )
 
   ensureDir(join(target, '.claude', 'rules'))
   const claudeRule = join(PKG_ROOT, '.claude', 'rules', 'duaer-spec.md')
@@ -269,6 +273,17 @@ function installClaudeMethod(target, opts) {
   console.log('  CLAUDE.md')
 }
 
+function installCodexMethod(target, opts) {
+  // Codex discovers repo skills under .agents/skills (not .codex/skills).
+  // Always-on guidance is AGENTS.md (installed with ops).
+  mirrorDuaerSkills(
+    target,
+    join(target, '.agents', 'skills'),
+    opts,
+    '.agents/skills/duaer-*  (Codex; mirrored from .cursor/skills)',
+  )
+}
+
 function cursorRuleToClaude(mdc, skillHost) {
   let body = mdc.replace(/^---\n[\s\S]*?\n---\n+/, (fm) => {
     const desc = (fm.match(/^description:\s*(.+)$/m) || [])[1]
@@ -413,7 +428,7 @@ function cmdInit(opts) {
   console.log(`
 Hired.
 
-Talk to the agent in plain language.
+Talk to the agent in plain language (Cursor, Claude Code, or Codex).
 Later update:  npx duaer-spec update
 `)
 }
@@ -551,6 +566,7 @@ function checkWorkplace(target) {
     ['.cursor/skills/duaer-specify/SKILL.md', 'method'],
     ['.claude/rules/duaer-spec.md', 'method'],
     ['.claude/skills/duaer-do/SKILL.md', 'method'],
+    ['.agents/skills/duaer-do/SKILL.md', 'method'],
     ['CLAUDE.md', 'method'],
     ['AGENTS.md', 'ops'],
     ['.cursor/rules/agents-workflow.mdc', 'ops'],

package/docs/agent/e2e-test-plan.md

@@ -39,6 +39,7 @@ the table for their app.
 | E2E-012 | `README.zh-CN.md` covers install, update, branch model | manual |
 | E2E-013 | Worktree id ≠ Brief `<nnn-slug>`; path is `.worktree/feat-…/.duaer/specs/…` | manual |
 | E2E-014 | Init installs Cursor + Claude hosts (`CLAUDE.md`, `.claude/skills`) | manual |
+| E2E-015 | Init installs Codex skills under `.agents/skills/` | manual |
 
 ## Traceability
 
@@ -58,3 +59,4 @@ the table for their app.
 | E2E-012 | `README.zh-CN.md` | Chinese 说明文档 |
 | E2E-013 | AGENTS / branching naming | Avoid double `<nnn-slug>` |
 | E2E-014 | Claude + Cursor install | Dual host |
+| E2E-015 | Codex `.agents/skills` | Triple host |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "duaer-spec",
-  "version": "0.7.0",
-  "description": "Digital employees for Cursor and Claude Code; main/develop/feat/fix",
+  "version": "0.8.0",
+  "description": "Digital employees for Cursor, Claude Code, and Codex; main/develop/feat/fix",
   "type": "module",
   "bin": {
     "duaer": "bin/duaer.mjs",
@@ -47,7 +47,9 @@
     "ai-engineering",
     "controllable-delivery",
     "claude",
-    "claude-code"
+    "claude-code",
+    "codex",
+    "openai-codex"
   ],
   "license": "MIT",
   "scripts": {