oh-my-customcodex 0.4.13 → 0.4.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -3
- package/dist/cli/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/ontology/skills.yaml +14 -0
- package/templates/.claude/skills/goal/SKILL.md +86 -0
- package/templates/.claude/skills/help/SKILL.md +2 -0
- package/templates/.claude/skills/lists/SKILL.md +3 -1
- package/templates/.claude/skills/omcodex-release-notes/SKILL.md +10 -0
- package/templates/.claude/skills/status/SKILL.md +2 -2
- package/templates/AGENTS.md.en +2 -1
- package/templates/AGENTS.md.ko +2 -1
- package/templates/CLAUDE.md +2 -2
- package/templates/CLAUDE.md.en +2 -1
- package/templates/CLAUDE.md.ko +2 -1
- package/templates/manifest.json +2 -2
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
|
|
14
14
|
**[한국어 문서 (Korean)](./README_ko.md)**
|
|
15
15
|
|
|
16
|
-
49 agents.
|
|
16
|
+
49 agents. 118 skills. 22 rules. One command.
|
|
17
17
|
|
|
18
18
|
```bash
|
|
19
19
|
npm install -g oh-my-customcodex && cd your-project && omcustomcodex init
|
|
@@ -134,7 +134,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
|
|
|
134
134
|
|
|
135
135
|
---
|
|
136
136
|
|
|
137
|
-
### Skills (
|
|
137
|
+
### Skills (118)
|
|
138
138
|
|
|
139
139
|
| Category | Count | Includes |
|
|
140
140
|
|----------|-------|----------|
|
|
@@ -170,6 +170,7 @@ All commands are invoked inside the oh-my-customcodex GPT Codex + OMX session.
|
|
|
170
170
|
| `/ambiguity-gate` | Pre-routing ambiguity analysis |
|
|
171
171
|
| `/pre-generation-arch-check` | Check architecture risks before implementation |
|
|
172
172
|
| `/adversarial-review` | Attacker-mindset security code review |
|
|
173
|
+
| `/goal` | Keep a concrete objective in view through planning, execution, and verification |
|
|
173
174
|
| `/pipeline` | Execute YAML-defined pipelines |
|
|
174
175
|
| `/pipeline resume` | Resume a halted pipeline from last failure point |
|
|
175
176
|
|
|
@@ -286,7 +287,7 @@ your-project/
|
|
|
286
287
|
│ ├── contexts/ # 4 shared context files
|
|
287
288
|
│ └── ontology/ # Knowledge graph for RAG
|
|
288
289
|
├── .agents/
|
|
289
|
-
│ └── skills/ #
|
|
290
|
+
│ └── skills/ # 118 installed skill modules
|
|
290
291
|
└── guides/ # 47 reference documents
|
|
291
292
|
```
|
|
292
293
|
|
package/dist/cli/index.js
CHANGED
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -45,6 +45,10 @@ classes:
|
|
|
45
45
|
skills: [status, help, lists]
|
|
46
46
|
description: "System information and utilities"
|
|
47
47
|
|
|
48
|
+
GoalWorkflowSkill:
|
|
49
|
+
skills: [goal]
|
|
50
|
+
description: "Goal-to-execution workflow coordination"
|
|
51
|
+
|
|
48
52
|
VerificationSkill:
|
|
49
53
|
skills: [sauron-watch]
|
|
50
54
|
description: "Verification and compliance"
|
|
@@ -174,6 +178,16 @@ skills:
|
|
|
174
178
|
keywords: [review, code-review, best-practices, quality]
|
|
175
179
|
rule_references: []
|
|
176
180
|
|
|
181
|
+
goal:
|
|
182
|
+
class: GoalWorkflowSkill
|
|
183
|
+
description: "Goal-to-execution workflow for disciplined Codex + OMX task completion"
|
|
184
|
+
user_invocable: true
|
|
185
|
+
model_invocable: true
|
|
186
|
+
scope: core
|
|
187
|
+
summary: "Keep a concrete objective visible through clarification, planning, execution, verification, and completion reporting"
|
|
188
|
+
keywords: [goal, objective, planning, execution, verification, completion]
|
|
189
|
+
rule_references: [R020]
|
|
190
|
+
|
|
177
191
|
docker-best-practices:
|
|
178
192
|
class: BestPracticeSkill
|
|
179
193
|
description: "Docker patterns for optimized containerization"
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: goal
|
|
3
|
+
description: Goal-to-execution workflow for disciplined Codex + OMX task completion
|
|
4
|
+
scope: core
|
|
5
|
+
version: 1.0.0
|
|
6
|
+
user-invocable: true
|
|
7
|
+
argument-hint: "<objective>"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# /goal - Goal-To-Execution Workflow
|
|
11
|
+
|
|
12
|
+
Use `/goal <objective>` when the user wants Codex to keep a concrete objective in view until it is genuinely complete.
|
|
13
|
+
|
|
14
|
+
This is the Codex + OMX port of the upstream goal workflow. It is implemented as a normal skill surface and does not depend on native Codex feature flags such as `features.goals`.
|
|
15
|
+
|
|
16
|
+
## Contract
|
|
17
|
+
|
|
18
|
+
When invoked with an objective:
|
|
19
|
+
|
|
20
|
+
1. Treat the supplied text as the concrete goal.
|
|
21
|
+
2. Ask only for requirements that are materially missing, risky, or blocking.
|
|
22
|
+
3. Inspect the relevant repository context before planning implementation.
|
|
23
|
+
4. Produce a short execution plan for non-trivial work.
|
|
24
|
+
5. Execute using existing project conventions, routing skills, and specialist agents when useful.
|
|
25
|
+
6. Verify completion before claiming the goal is done.
|
|
26
|
+
7. Report changed files, verification evidence, and remaining risks.
|
|
27
|
+
|
|
28
|
+
## Workflow
|
|
29
|
+
|
|
30
|
+
### 1. Capture Goal
|
|
31
|
+
|
|
32
|
+
Restate the objective in one sentence. If the runtime exposes goal tracking, register the objective there. Otherwise keep the objective visible in the active task state.
|
|
33
|
+
|
|
34
|
+
Do not broaden the goal beyond the user's words without confirming the added scope.
|
|
35
|
+
|
|
36
|
+
### 2. Clarify Only Blockers
|
|
37
|
+
|
|
38
|
+
Ask at most three short questions, and only when the answer changes the implementation path or risk profile. If reasonable defaults exist, state the assumption and continue.
|
|
39
|
+
|
|
40
|
+
### 3. Inspect Context
|
|
41
|
+
|
|
42
|
+
Search and read the smallest useful set of files before editing. Prefer `rg`/`rg --files` for repository discovery. Identify:
|
|
43
|
+
|
|
44
|
+
- Existing implementation patterns.
|
|
45
|
+
- Tests or validators that cover the affected surface.
|
|
46
|
+
- Provider-boundary constraints for this repository.
|
|
47
|
+
- User or worktree changes that must be preserved.
|
|
48
|
+
|
|
49
|
+
### 4. Plan
|
|
50
|
+
|
|
51
|
+
For non-trivial work, produce a concise plan with:
|
|
52
|
+
|
|
53
|
+
- Files or modules likely to change.
|
|
54
|
+
- Verification commands.
|
|
55
|
+
- Risks or assumptions.
|
|
56
|
+
|
|
57
|
+
Skip the visible plan for tiny, obvious changes, but still do the context check.
|
|
58
|
+
|
|
59
|
+
### 5. Execute
|
|
60
|
+
|
|
61
|
+
Use the repository's established tools and style. Keep edits scoped to the goal. Delegate through routing skills or agents when the task crosses ownership boundaries, needs specialized review, or benefits from parallel independent work.
|
|
62
|
+
|
|
63
|
+
In oh-my-customcodex, use `omcustomcodex` in command examples and operator guidance. Do not introduce `omcustom` instructions.
|
|
64
|
+
|
|
65
|
+
### 6. Verify
|
|
66
|
+
|
|
67
|
+
Run the narrowest meaningful verification first, then broaden when the change touches shared behavior, generated catalogs, release flow, or user-facing docs. If verification cannot run, report why.
|
|
68
|
+
|
|
69
|
+
### 7. Complete
|
|
70
|
+
|
|
71
|
+
Finish with:
|
|
72
|
+
|
|
73
|
+
- What changed.
|
|
74
|
+
- Verification evidence.
|
|
75
|
+
- Remaining risks or follow-up work.
|
|
76
|
+
|
|
77
|
+
Do not mark the goal complete until the acceptance criteria are satisfied or the user explicitly accepts a partial result.
|
|
78
|
+
|
|
79
|
+
## Acceptance Checklist
|
|
80
|
+
|
|
81
|
+
- Objective stayed fixed unless the user changed it.
|
|
82
|
+
- Blocking ambiguity was resolved or called out.
|
|
83
|
+
- Relevant context was inspected before edits.
|
|
84
|
+
- Implementation followed local patterns.
|
|
85
|
+
- Verification evidence is current.
|
|
86
|
+
- Final response includes changed files and residual risk.
|
|
@@ -30,8 +30,10 @@ Quick Start:
|
|
|
30
30
|
lists Show all available commands
|
|
31
31
|
status Show system status
|
|
32
32
|
help <command> Get help for a specific command
|
|
33
|
+
/goal <objective> Run a goal-to-execution workflow
|
|
33
34
|
|
|
34
35
|
Common Commands:
|
|
36
|
+
/goal Keep an objective through planning, execution, and verification
|
|
35
37
|
/update-docs Sync documentation with project
|
|
36
38
|
/update-external Update external agents
|
|
37
39
|
/audit-agents Check agent dependencies
|
|
@@ -27,6 +27,7 @@ System:
|
|
|
27
27
|
lists Show all available commands
|
|
28
28
|
status Show system status
|
|
29
29
|
help Show help information
|
|
30
|
+
/goal Run a goal-to-execution workflow
|
|
30
31
|
|
|
31
32
|
Manager:
|
|
32
33
|
/create-agent Create a new agent
|
|
@@ -55,6 +56,7 @@ System Commands:
|
|
|
55
56
|
│ lists │ Show all available commands │
|
|
56
57
|
│ status │ Show system status and health checks │
|
|
57
58
|
│ help │ Show help for commands and agents │
|
|
59
|
+
│ /goal │ Run a goal-to-execution workflow │
|
|
58
60
|
└─────────┴──────────────────────────────────────────────┘
|
|
59
61
|
|
|
60
62
|
Manager Commands:
|
|
@@ -76,5 +78,5 @@ Dev Commands:
|
|
|
76
78
|
│ /dev-refactor│ Suggest and apply refactoring │
|
|
77
79
|
└──────────────┴────────────────────────────────────────┘
|
|
78
80
|
|
|
79
|
-
Total:
|
|
81
|
+
Total: 11 commands available
|
|
80
82
|
```
|
|
@@ -39,6 +39,16 @@ git diff --name-status ${PREV_TAG}..HEAD
|
|
|
39
39
|
gh issue list --state closed --search "closed:>$(git log -1 --format=%ci ${PREV_TAG} | cut -d' ' -f1)" --json number,title,labels
|
|
40
40
|
```
|
|
41
41
|
|
|
42
|
+
### Phase 1.5: Promote CHANGELOG
|
|
43
|
+
|
|
44
|
+
Before creating a release, keep `CHANGELOG.md` as the durable source of release history:
|
|
45
|
+
|
|
46
|
+
1. Confirm `CHANGELOG.md` has a `## [Unreleased]` section.
|
|
47
|
+
2. Move non-empty `Unreleased` entries into `## [VERSION] - YYYY-MM-DD`.
|
|
48
|
+
3. Insert a fresh empty `## [Unreleased]` section above the promoted version.
|
|
49
|
+
4. Verify `.github/workflows/release.yml` can extract the promoted section with its existing `awk "/^## \\[${VERSION}\\]/{flag=1; next} /^## \\[/{flag=0} flag"` logic.
|
|
50
|
+
5. If `Unreleased` is empty, add the release summary there first rather than relying only on GitHub auto-generated notes.
|
|
51
|
+
|
|
42
52
|
### Phase 2: Classify Changes
|
|
43
53
|
|
|
44
54
|
Categorize commits using Conventional Commits:
|
|
@@ -41,7 +41,7 @@ Skills:
|
|
|
41
41
|
Total: 13 skills
|
|
42
42
|
|
|
43
43
|
Guides: 12 loaded
|
|
44
|
-
Commands:
|
|
44
|
+
Commands: 11 available
|
|
45
45
|
|
|
46
46
|
Health: ✓ OK
|
|
47
47
|
```
|
|
@@ -122,7 +122,7 @@ Guides:
|
|
|
122
122
|
✓ docker, aws
|
|
123
123
|
|
|
124
124
|
Commands:
|
|
125
|
-
system: lists, status, help
|
|
125
|
+
system: lists, status, help, goal
|
|
126
126
|
manager: create-agent, update-docs, update-external, audit-agents, fix-refs
|
|
127
127
|
dev: dev-review, dev-refactor
|
|
128
128
|
|
package/templates/AGENTS.md.en
CHANGED
|
@@ -118,6 +118,7 @@ NO EXCEPTIONS. NO EXCUSES.
|
|
|
118
118
|
| `/deep-plan` | Research-validated planning (research → plan → verify) |
|
|
119
119
|
| `/omcustomcodex:sauron-watch` | Full R017 verification |
|
|
120
120
|
| `/structured-dev-cycle` | 6-stage structured development cycle (Plan → Verify → Implement → Verify → Compound → Done) |
|
|
121
|
+
| `/goal` | Keep a concrete objective through planning, execution, and verification |
|
|
121
122
|
| `/omcustomcodex:lists` | Show all available commands |
|
|
122
123
|
| `/omcustomcodex:status` | Show system status |
|
|
123
124
|
| `/omcustomcodex:help` | Show help information |
|
|
@@ -133,7 +134,7 @@ project/
|
|
|
133
134
|
| +-- hooks/ # Hook scripts (security, validation, HUD)
|
|
134
135
|
| +-- contexts/ # Context files (ecomode)
|
|
135
136
|
+-- .agents/
|
|
136
|
-
| +-- skills/ # Installed skills (
|
|
137
|
+
| +-- skills/ # Installed skills (118 directories)
|
|
137
138
|
+-- guides/ # Reference docs (26 topics)
|
|
138
139
|
```
|
|
139
140
|
|
package/templates/AGENTS.md.ko
CHANGED
|
@@ -118,6 +118,7 @@ oh-my-customcodex로 구동됩니다.
|
|
|
118
118
|
| `/deep-plan` | 연구 검증 기반 계획 수립 (research → plan → verify) |
|
|
119
119
|
| `/omcustomcodex:sauron-watch` | 전체 R017 검증 |
|
|
120
120
|
| `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
|
|
121
|
+
| `/goal` | 구체 목표를 계획, 실행, 검증까지 유지 |
|
|
121
122
|
| `/omcustomcodex:lists` | 모든 사용 가능한 커맨드 표시 |
|
|
122
123
|
| `/omcustomcodex:status` | 시스템 상태 표시 |
|
|
123
124
|
| `/omcustomcodex:help` | 도움말 표시 |
|
|
@@ -133,7 +134,7 @@ project/
|
|
|
133
134
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
134
135
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
135
136
|
+-- .agents/
|
|
136
|
-
| +-- skills/ # 설치된 스킬 (
|
|
137
|
+
| +-- skills/ # 설치된 스킬 (118 디렉토리)
|
|
137
138
|
+-- guides/ # 레퍼런스 문서 (26 토픽)
|
|
138
139
|
```
|
|
139
140
|
|
package/templates/CLAUDE.md
CHANGED
|
@@ -99,7 +99,7 @@ oh-my-customcodex로 구동됩니다.
|
|
|
99
99
|
|----------|------------|------|
|
|
100
100
|
| 프로젝트 관리 | `/omcustomcodex:analysis`, `/omcustomcodex:create-agent`, `/omcustomcodex:audit-agents` | 분석, 에이전트/스킬 생성, 감사 |
|
|
101
101
|
| 아이디어 | `/idea` | 자연어 아이디어를 구조화된 이슈 스펙으로 변환 |
|
|
102
|
-
| 개발 | `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 코드 리뷰, 리팩토링, SDD |
|
|
102
|
+
| 개발 | `/goal`, `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 목표 실행, 코드 리뷰, 리팩토링, SDD |
|
|
103
103
|
| 검증 | `/omcustomcodex:sauron-watch`, `/deep-verify`, `/adversarial-review` | R017 검증, 릴리즈 품질, 보안 리뷰 |
|
|
104
104
|
| 릴리즈 | `/pipeline auto-dev`, `/omcustomcodex-release-notes`, `/release-plan` | 자동 개발, 릴리즈 노트 |
|
|
105
105
|
| 리서치 | `/research`, `/scout`, `/deep-plan`, `/omcustomcodex:agora` | 병렬 분석, URL 평가, 연구 계획 |
|
|
@@ -119,7 +119,7 @@ project/
|
|
|
119
119
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
120
120
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
121
121
|
+-- .agents/
|
|
122
|
-
| +-- skills/ # 스킬 (
|
|
122
|
+
| +-- skills/ # 스킬 (118 디렉토리)
|
|
123
123
|
+-- guides/ # 레퍼런스 문서 (39 토픽)
|
|
124
124
|
```
|
|
125
125
|
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -121,6 +121,7 @@ NO EXCEPTIONS. NO EXCUSES.
|
|
|
121
121
|
| `/pre-generation-arch-check` | Check architecture risks before implementation |
|
|
122
122
|
| `/omcustomcodex:sauron-watch` | Full R017 verification |
|
|
123
123
|
| `/structured-dev-cycle` | 6-stage structured development cycle (Plan → Verify → Implement → Verify → Compound → Done) |
|
|
124
|
+
| `/goal` | Keep a concrete objective through planning, execution, and verification |
|
|
124
125
|
| `/omcustomcodex:lists` | Show all available commands |
|
|
125
126
|
| `/omcustomcodex:status` | Show system status |
|
|
126
127
|
| `/omcustomcodex:help` | Show help information |
|
|
@@ -132,7 +133,7 @@ project/
|
|
|
132
133
|
+-- AGENTS.md # Entry point
|
|
133
134
|
+-- .codex/
|
|
134
135
|
| +-- agents/ # Subagent definitions (49 files)
|
|
135
|
-
| +-- skills/ # Skills (
|
|
136
|
+
| +-- skills/ # Skills (118 directories)
|
|
136
137
|
| +-- rules/ # Global rules (22 files)
|
|
137
138
|
| +-- hooks/ # Hook scripts (security, validation, HUD)
|
|
138
139
|
| +-- contexts/ # Context files (4 files)
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -121,6 +121,7 @@ oh-my-customcodex로 구동됩니다.
|
|
|
121
121
|
| `/pre-generation-arch-check` | 구현 전 아키텍처 위험 점검 |
|
|
122
122
|
| `/omcustomcodex:sauron-watch` | 전체 R017 검증 |
|
|
123
123
|
| `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
|
|
124
|
+
| `/goal` | 구체 목표를 계획, 실행, 검증까지 유지 |
|
|
124
125
|
| `/omcustomcodex:lists` | 모든 사용 가능한 커맨드 표시 |
|
|
125
126
|
| `/omcustomcodex:status` | 시스템 상태 표시 |
|
|
126
127
|
| `/omcustomcodex:help` | 도움말 표시 |
|
|
@@ -132,7 +133,7 @@ project/
|
|
|
132
133
|
+-- AGENTS.md # 진입점
|
|
133
134
|
+-- .codex/
|
|
134
135
|
| +-- agents/ # 서브에이전트 정의 (49 파일)
|
|
135
|
-
| +-- skills/ # 스킬 (
|
|
136
|
+
| +-- skills/ # 스킬 (118 디렉토리)
|
|
136
137
|
| +-- rules/ # 전역 규칙 (22 파일)
|
|
137
138
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
138
139
|
| +-- contexts/ # 컨텍스트 파일 (4 파일)
|
package/templates/manifest.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.4.
|
|
2
|
+
"version": "0.4.15",
|
|
3
3
|
"requiresCC": ">=2.1.121",
|
|
4
4
|
"claudeCode": {
|
|
5
5
|
"minimumVersion": "2.1.121",
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
"name": "skills",
|
|
24
24
|
"path": ".agents/skills",
|
|
25
25
|
"description": "Reusable skill modules (project-scoped repo skills)",
|
|
26
|
-
"files":
|
|
26
|
+
"files": 118
|
|
27
27
|
},
|
|
28
28
|
{
|
|
29
29
|
"name": "guides",
|