@kaydash9999/banker-plugins 0.21.0 → 0.22.0

package/skills/motion-graphic-make/SKILL.md

@@ -14,7 +14,7 @@ description: "10초 안팎의 내레이션 없는 모션 그래픽(키네틱 타
 이 스킬은 hyperframes CLI 가 설치, 정상 동작해야 한다.
 **진행 전 가용성을 먼저 확인**하고, 문제가 있으면 **설치부터 안내**한다(추정, 임의 재설치 금지):
 - 확인: `npx hyperframes doctor`(오프라인에서는 전역 설치한 `hyperframes doctor`. 깔린 것이 없으면 `npx` 가 패키지를 받으려 해 네트워크가 없으면 약 70초 뒤 실패한다)
-- 실패/미설치면 먼저 `motion-graphic-setup` 스킬로 설치(Claude Code: `/banker:setup` 에서 motion-graphic-setup / Codex: `banker-motion-graphic-setup`). 설치, 검증 후 이 스킬을 이어서 진행한다.
+- 실패/미설치면 먼저 `motion-graphic-setup` 스킬로 설치(Claude Code: `/banker:setup` 에서 motion-graphic-setup / Codex: `banker-motion-graphic-setup`, 플러그인 설치면 `banker:motion-graphic-setup`). 설치, 검증 후 이 스킬을 이어서 진행한다.
 - 독립 검증에서 배치한 페이지를 잴 때는 Node 용 playwright 패키지와 Chromium 이 필요하다(`npm i -g playwright && npx playwright install chromium`).
 
 ## hyperframes 란 (요약)

package/skills/obsidizer/SKILL.md

@@ -82,21 +82,36 @@ banker의 **첫 플러그인 선언 hook**(`hooks/hooks.json`)이 OMC 위키 쓰
 없음). 플래그가 없으면 hook은 즉시 exit 0. 방금 banker를 설치/갱신한 세션이면 완료 보고에
 **`/reload-plugins`** 실행을 안내한다(hot-reload 경로).
 
-Codex 에서는 플래그 자리가 `omx_wiki/.obsidizer` 이고, hook 은 banker 가 Codex 사용자 범위에 따로 설치한다.
+Codex 에서는 플래그 자리가 `omx_wiki/.obsidizer` 이고, hook 은 `--enable` 할 때만 Codex 사용자 범위에 따로 설치한다.
+hook 이 셸 호출마다 node 를 띄우므로 쓰지 않는 사람에게는 넣지 않는다. 설치 길과 관계없이 같다.
+아래 `<banker>` 는 `"<node>" "<banker.js>"` 다. 샌드박스 밖에서 도는 명령이므로 PATH 의 `banker` 를 이름으로 부르지 않고 두 절대경로로 쓴다.
+- `<banker.js>`: Codex 플러그인 설치(`codex plugin add`, 이 SKILL.md 가 `plugins/cache/` 아래)면 `<이 SKILL.md 가 있는 폴더>/../../bin/banker.js`
+  (플러그인 폴더의 같은 프로그램). npm 설치면 PATH 의 `banker` 가 가리키는 파일의 실제 경로
+  - macOS, Linux: `node -p "require('fs').realpathSync(process.argv[1])" "$(command -v banker)"`(npm 이 만든 링크가 `bin/banker.js` 로 풀림)
+  - Windows: `Join-Path (Split-Path (Get-Command banker.cmd).Source) 'node_modules\@kaydash9999\banker-plugins\bin\banker.js'`
+  - 그 파일이 없거나 이름이 `banker.js` 가 아니면 샌드박스 밖 실행을 요청하지 않고 그 이유를 보고한 뒤 멈춘다
+- `<node>`: 샌드박스 안에서 `node -p "require('fs').realpathSync(process.execPath)"` 로 얻은 실제 경로
+- 두 경로 중 하나라도 임시 폴더나 작업 폴더 안이면(샌드박스가 바꿀 수 있는 곳) 샌드박스 밖 실행을 요청하지 않고 그 이유를 보고한 뒤 멈춘다. 작업 폴더가 홈 폴더
+  자체이면 작업 폴더 규칙은 적용하지 않는다(nvm 처럼 홈 아래 둔 node)
+- Windows 의 PowerShell 에서는 앞에 호출 연산자를 붙여 `& "<node>" "<banker.js>" hooks enable obsidize` 처럼 쓴다(없으면 구문 오류)
+이 hook 은 그때의 사본(`~/.codex/hooks-custom/banker/`)으로 돌아, 플러그인이 새 판으로 올라가도 바뀌지 않는다. `hooks status obsidize` 가
+`stale` 이면 `--enable` 을 다시 실행해 새 판으로 바꾼다.
 
 - `--enable`
   1. 작업 폴더에 `omx_wiki/` 가 없으면 만들고 `omx_wiki/.obsidizer` 를 쓴다. `omx_wiki/` 는 저장소에
      넣는 폴더라 이 플래그도 커밋 대상이 될 수 있음을 보고에 적는다.
-  2. `banker hooks status obsidize` 로 hook 상태를 본다. `on` 이면 3을 건너뛴다.
-  3. `banker hooks enable obsidize` 를 실행한다. 이 명령은 `~/.codex/hooks.json` 과
+  2. `<banker> hooks status obsidize` 로 hook 상태를 본다. `on` 이면 3을 건너뛴다.
+  3. `<banker> hooks enable obsidize` 를 실행한다. 이 명령은 `~/.codex/hooks.json` 과
      `~/.codex/hooks-custom/banker/` 에 쓰므로 `workspace-write` 샌드박스 밖에서 돌아야 한다. 그 한 명령만
      샌드박스 밖 실행 승인을 요청한다. `--add-dir ~/.codex` 는 권하지 않는다(세션이 훅과 신뢰 기록을 고칠 수
      있게 됨). 승인을 요청할 수 없으면(`codex exec`, 승인 정책 `never`) 실행하지 않고, 사용자가 입력창에
-     `! banker hooks enable obsidize` 로 직접 실행하도록 안내한 뒤 멈춘다.
+     `! <banker> hooks enable obsidize`(실제 명령으로 바꿔 적음)로 직접 실행하도록 안내한 뒤 멈춘다.
   4. Codex 를 다시 열 때 뜨는 Hooks need review 창이나 `/hooks` 에서 banker obsidize hook 을 신뢰해야
      돈다고 보고한다. 신뢰 전에는 플래그가 있어도 정규화되지 않는다.
 - `--disable`: `omx_wiki/.obsidizer` 를 지운다. hook 은 다른 프로젝트의 플래그도 보므로 남겨 두고, 어느
-  프로젝트에서도 쓰지 않으면 `banker hooks disable obsidize` 로 뺄 수 있다고 안내한다(같은 승인 규칙).
+  프로젝트에서도 쓰지 않으면 `<banker> hooks disable obsidize` 로 뺄 수 있다고 안내한다(같은 승인 규칙).
+  이 hook 은 `codex plugin remove` 로 지워지지 않는다(사용자 범위에 따로 있음). 플러그인을 지우기 전에 `<banker> hooks disable obsidize`
+  를 실행하라고 함께 안내한다.
 
 ## 변환 규칙
 

package/skills/payload-mon/SKILL.md

@@ -16,7 +16,7 @@ Claude Code 는 요청 본문이 32MB 를 넘으면 "Request too large (max 32MB
 ## 실행
 
 이 SKILL.md 가 있는 디렉터리의 절대경로로 스크립트를 실행하고, 출력 내용을 짧게 전한다.
-Claude Code 는 그 경로를 스킬 맨 위 "Base directory for this skill:" 로 보여 주고, Codex 는 `~/.codex/skills/banker-payload-mon/` 이다(프로젝트 범위 설치면 `./.codex/skills/banker-payload-mon/`).
+Claude Code 는 그 경로를 스킬 맨 위 "Base directory for this skill:" 로 보여 주고, Codex 는 스킬 목록의 이 SKILL.md 경로(file)로 보여 준다. npm 설치는 `~/.codex/skills/banker-payload-mon/`(프로젝트 범위 설치면 `./.codex/skills/banker-payload-mon/`), 플러그인 설치(`codex plugin add`)는 `~/.codex/plugins/cache/<마켓플레이스>/banker/<판>/skills/payload-mon/` 이다.
 `~` 는 따옴표 안에서 펼쳐지지 않으니 절대경로를 쓴다.
 
 ```bash

package/skills/play-qa/SKILL.md

@@ -10,7 +10,7 @@ description: "Godot 로 만든 HTML5 웹 게임을 실제 브라우저에서 Pla
 ## 0. 전제조건: playwright (없으면 설치부터)
 이 스킬은 playwright 브라우저가 있어야 동작한다. **진행 전 설치 여부를 먼저 확인**하고, 없으면 **설치부터 안내**한다(추정·임의 재설치 금지):
 - 확인: `ls "${PLAYWRIGHT_BROWSERS_PATH:-$HOME/.cache/ms-playwright}" 2>/dev/null | grep -qi chromium && echo ok`
-- 미설치면 먼저 `setup-playwright` 스킬로 설치(Claude Code: `/banker:setup` → setup-playwright / Codex: `banker-setup-playwright`). 설치·검증 후 이 스킬을 이어서 진행한다.
+- 미설치면 먼저 `setup-playwright` 스킬로 설치(Claude Code: `/banker:setup` → setup-playwright / Codex: `banker-setup-playwright`, 플러그인 설치면 `banker:setup-playwright`). 설치·검증 후 이 스킬을 이어서 진행한다.
 
 ## 언제
 - 오너가 "네가 직접 플레이/qa해봐", "게임 테스트해봐" 류로 위임.

package/skills/ralph-qa/SKILL.md

@@ -112,7 +112,7 @@ node "<이 스킬 디렉터리 절대경로>/references/verifier-probe.mjs" --ru
 외부 좌석 CLI 는 에이전트다. 읽기 도구로 읽은 파일도 그 프로바이더로 간다. 그래서 좌석마다 페이로드 사본 하나만 든 폴더에서 띄우고, 답은 좌석 폴더 밖의 다른 폴더로 받는다.
 
 폴더, 페이로드, 비밀 검사, 좌석 명령, 시간 상한, 정리는 실행기 `references/seat-run.mjs` 가 한다. **좌석 명령과 git 사슬을 손으로 짜지 않는다.** 실행기가 멈추면 출력 JSON 의 `stop` 을 아래 멈춤 표대로 처리한다.
-`<R>` 은 `<이 스킬 디렉터리 절대경로>/references` 다(Codex 설치본은 `~/.codex/skills/banker-ralph-qa/references`, `CODEX_HOME` 이 있으면 그 아래 `skills/banker-ralph-qa/references`). 호출 사이에 셸 변수가 남지 않으므로 호출마다 실제 경로를 적는다.
+`<R>` 은 `<이 스킬 디렉터리 절대경로>/references` 다(Codex 의 npm 설치본은 `~/.codex/skills/banker-ralph-qa/references`, 플러그인 설치본은 `~/.codex/plugins/cache/<마켓플레이스>/banker/<판>/skills/ralph-qa/references`. `CODEX_HOME` 이 있으면 `~/.codex` 대신 그 폴더). 호출 사이에 셸 변수가 남지 않으므로 호출마다 실제 경로를 적는다.
 명령마다 stdout 에 JSON 하나를 내고, 같은 JSON 을 `<d>/result-<명령>.md` 에도 쓴다(멈춘 send 는 `result-send-stop.md`). 종료 코드는 0 끝남, 1 비밀처럼 보이는 줄, 2 인자나 실행기 오류, 3 멈춤, 4 512 KiB 초과, 5 send 가 아직 돎이다.
 반복마다 새 폴더를 만든다.
 

package/skills/remains/SKILL.md

@@ -41,7 +41,7 @@ argument-hint: "[기준 커밋] [--no-boxes]"
 
 ## 4. 테스트박스 (등록돼 있으면)
 
-박스 작업은 이 스킬 폴더의 `scripts/boxes.mjs` 가 한다(Codex 에서는 `~/.codex/skills/banker-remains/scripts/boxes.mjs`). Node 만 쓰고, 이 머신에 `ssh`, `scp`, `git`, 박스에 `tar` 가 있어야 한다. `--no-boxes` 를 받으면 이 단계를 건너뛰고 확인 범위에 그렇게 적는다.
+박스 작업은 이 스킬 폴더의 `scripts/boxes.mjs` 가 한다(Codex 의 npm 설치는 `~/.codex/skills/banker-remains/scripts/boxes.mjs`, 플러그인 설치는 `~/.codex/plugins/cache/<마켓플레이스>/banker/<판>/skills/remains/scripts/boxes.mjs`). Node 만 쓰고, 이 머신에 `ssh`, `scp`, `git`, 박스에 `tar` 가 있어야 한다. `--no-boxes` 를 받으면 이 단계를 건너뛰고 확인 범위에 그렇게 적는다.
 
 1. `node <스킬 폴더>/scripts/boxes.mjs list` 로 등록을 본다. 등록 파일이 없으면 확인 범위에 "테스트박스 미등록" 이라 적고 넘어간다.
 2. `node <스킬 폴더>/scripts/boxes.mjs probe` 로 접속을 확인한다.

package/skills/rfp-author/scripts/md2docx.py

@@ -16,30 +16,42 @@ if len(sys.argv) < 3:
     sys.exit(2)
 SRC = sys.argv[1]
 OUT = sys.argv[2]
-FONT = sys.argv[3] if len(sys.argv) > 3 else "Malgun Gothic"  # 한글 폰트(서버에 설치된 것으로 교체 가능)
+FONT = (
+    sys.argv[3] if len(sys.argv) > 3 else "Malgun Gothic"
+)  # 한글 폰트(서버에 설치된 것으로 교체 가능)
+
 
 def set_korean(style):
     style.font.name = FONT
     style.font.size = Pt(10)
     rpr = style.element.get_or_add_rPr()
-    rfonts = rpr.find(qn('w:rFonts'))
+    rfonts = rpr.find(qn("w:rFonts"))
     if rfonts is None:
-        rfonts = OxmlElement('w:rFonts'); rpr.append(rfonts)
-    for a in ('w:ascii', 'w:hAnsi', 'w:eastAsia', 'w:cs'):  # eastAsia 필수(누락 시 한글 깨짐)
+        rfonts = OxmlElement("w:rFonts")
+        rpr.append(rfonts)
+    for a in (
+        "w:ascii",
+        "w:hAnsi",
+        "w:eastAsia",
+        "w:cs",
+    ):  # eastAsia 필수(누락 시 한글 깨짐)
         rfonts.set(qn(a), FONT)
 
+
 def add_runs(p, text):
-    for part in re.split(r'(\*\*[^*]+\*\*)', text):
+    for part in re.split(r"(\*\*[^*]+\*\*)", text):
         if not part:
             continue
-        if part.startswith('**') and part.endswith('**'):
-            p.add_run(part[2:-2].replace('`', '')).bold = True
+        if part.startswith("**") and part.endswith("**"):
+            p.add_run(part[2:-2].replace("`", "")).bold = True
         else:
-            p.add_run(part.replace('`', ''))
+            p.add_run(part.replace("`", ""))
+
 
 def is_sep(cells):
     nonempty = [c.strip() for c in cells if c.strip()]
-    return bool(nonempty) and all(re.fullmatch(r':?-{1,}:?', c) for c in nonempty)
+    return bool(nonempty) and all(re.fullmatch(r":?-{1,}:?", c) for c in nonempty)
+
 
 def set_table_widths(t):
     # 균등 너비 금지: 맨 왼쪽 컬럼은 내용에 맞춰 최소폭(개행 없이), 나머지 컬럼이 잔여 폭 분배
@@ -60,66 +72,77 @@ def set_table_widths(t):
     t.autofit = False
     t.allow_autofit = False
     tblPr = t._tbl.tblPr
-    lay = tblPr.find(qn('w:tblLayout'))
+    lay = tblPr.find(qn("w:tblLayout"))
     if lay is None:
-        lay = OxmlElement('w:tblLayout'); tblPr.append(lay)
-    lay.set(qn('w:type'), 'fixed')  # 고정 레이아웃(지정 폭 준수)
+        lay = OxmlElement("w:tblLayout")
+        tblPr.append(lay)
+    lay.set(qn("w:type"), "fixed")  # 고정 레이아웃(지정 폭 준수)
     widths = [col0] + [rest] * (ncol - 1)
-    grid = t._tbl.find(qn('w:tblGrid'))
+    grid = t._tbl.find(qn("w:tblGrid"))
     if grid is not None:
-        for i, gc in enumerate(grid.findall(qn('w:gridCol'))):
+        for i, gc in enumerate(grid.findall(qn("w:gridCol"))):
             if i < len(widths):
-                gc.set(qn('w:w'), str(int(widths[i] * 1440)))  # inch→twips, 고정레이아웃 실폭(★ 이게 핵심)
+                gc.set(
+                    qn("w:w"), str(int(widths[i] * 1440))
+                )  # inch→twips, 고정레이아웃 실폭(★ 이게 핵심)
     for i, col in enumerate(t.columns):
         for cell in col.cells:
             cell.width = Inches(widths[i])
 
+
 doc = Document()
-set_korean(doc.styles['Normal'])
+set_korean(doc.styles["Normal"])
 
-lines = open(SRC, encoding='utf-8').read().split('\n')
+lines = open(SRC, encoding="utf-8").read().split("\n")
 i, n = 0, len(lines)
 while i < n:
     s = lines[i].strip()
     if not s:
-        i += 1; continue
-    if s.startswith('|'):
+        i += 1
+        continue
+    if s.startswith("|"):
         block = []
-        while i < n and lines[i].strip().startswith('|'):
-            block.append(lines[i].strip()); i += 1
+        while i < n and lines[i].strip().startswith("|"):
+            block.append(lines[i].strip())
+            i += 1
+
         def split_row(tl):
-            return [c.strip() for c in tl.strip('|').split('|')]
+            return [c.strip() for c in tl.strip("|").split("|")]
+
         rows = [split_row(tl) for tl in block]
         rows = [r for r in rows if not is_sep(r)]
         if rows:
             ncol = max(len(r) for r in rows)
-            t = doc.add_table(rows=0, cols=ncol); t.style = 'Table Grid'
+            t = doc.add_table(rows=0, cols=ncol)
+            t.style = "Table Grid"
             for ri, r in enumerate(rows):
                 rc = t.add_row().cells
                 for ci in range(ncol):
                     para = rc[ci].paragraphs[0]
-                    add_runs(para, r[ci] if ci < len(r) else '')
+                    add_runs(para, r[ci] if ci < len(r) else "")
                     if ri == 0:
                         for run in para.runs:
                             run.bold = True
             set_table_widths(t)
             doc.add_paragraph()  # spacer after table (표와 다음 단락 겹침 방지)
         continue
-    if s.startswith('### '):
+    if s.startswith("### "):
         doc.add_heading(s[4:], level=2)
-    elif s.startswith('## '):
+    elif s.startswith("## "):
         doc.add_heading(s[3:], level=1)
-    elif s.startswith('# '):
-        h0 = doc.add_heading('', level=0); add_runs(h0, s[2:])
+    elif s.startswith("# "):
+        h0 = doc.add_heading("", level=0)
+        add_runs(h0, s[2:])
         for r in h0.runs:
             r.font.size = Pt(20)
-    elif s.startswith('> '):
-        p = doc.add_paragraph(); add_runs(p, s[2:])
+    elif s.startswith("> "):
+        p = doc.add_paragraph()
+        add_runs(p, s[2:])
         for run in p.runs:
             run.italic = True
             run.font.size = Pt(8)
-    elif s.startswith('- '):
-        add_runs(doc.add_paragraph(style='List Bullet'), s[2:])
+    elif s.startswith("- "):
+        add_runs(doc.add_paragraph(style="List Bullet"), s[2:])
     else:
         add_runs(doc.add_paragraph(), s)
     i += 1
@@ -128,9 +151,15 @@ while i < n:
 fp = doc.sections[0].footer.paragraphs[0]
 fp.alignment = WD_ALIGN_PARAGRAPH.CENTER
 run = fp.add_run()
-for tag, kw in (('w:fldChar', {'w:fldCharType': 'begin'}), (None, None), ('w:fldChar', {'w:fldCharType': 'end'})):
+for tag, kw in (
+    ("w:fldChar", {"w:fldCharType": "begin"}),
+    (None, None),
+    ("w:fldChar", {"w:fldCharType": "end"}),
+):
     if tag is None:
-        el = OxmlElement('w:instrText'); el.set(qn('xml:space'), 'preserve'); el.text = 'PAGE'
+        el = OxmlElement("w:instrText")
+        el.set(qn("xml:space"), "preserve")
+        el.text = "PAGE"
     else:
         el = OxmlElement(tag)
         for k, v in kw.items():

package/skills/setup-bypass-permissions/SKILL.md

@@ -28,7 +28,7 @@ disable-model-invocation: true
 (대상 codex) 확인만 줄이고 샌드박스는 남기려면 이 스킬 대신 `approval_policy = "never"` 만 두는 방법이 있습니다. 그때 작업 폴더 밖 쓰기와 네트워크는 실패합니다.
 대상이 `claude` 면 Codex 에서 실행해도 바뀌는 것은 같은 머신의 Claude Code 설정입니다.
 대상이 `codex` 면 이 계정의 모든 Codex 세션이 명령을 묻지 않고 샌드박스 없이 실행합니다(`codex --dangerously-bypass-approvals-and-sandbox` 와 같음). `codex exec` 같은 비대화형 실행도 같습니다. 샌드박스가 꺼져 작업 폴더 밖 파일과 네트워크에도 제한이 없습니다.
-되돌리려면 `/banker:setup-bypass-permissions off` 를 실행하십시오. Codex 대상은 `$banker-setup-bypass-permissions off codex` 입니다.
+되돌리려면 `/banker:setup-bypass-permissions off` 를 실행하십시오. Codex 대상은 `$banker-setup-bypass-permissions off codex`(플러그인 설치면 `$banker:setup-bypass-permissions off codex`) 입니다.
 
 ## 대상
 
@@ -52,7 +52,7 @@ disable-model-invocation: true
 ## 절차
 
 `<스킬 폴더>` 는 이 SKILL.md 가 있는 폴더의 절대경로다.
-Codex 에서는 설치된 `banker-setup-bypass-permissions` 폴더다.
+Codex 에서는 설치된 `banker-setup-bypass-permissions` 폴더다(플러그인 설치면 스킬 목록의 이 SKILL.md 경로가 든 폴더).
 
 1. 확인 (`on` 일 때만)
    - 위 경고 전부를 일반 출력으로 먼저 보여 준다.

package/skills/setup-bypass-permissions/scripts/fallback/bypass-permissions.py

@@ -21,6 +21,7 @@ Exit status: 0 done, or nothing to do. 1 refused. 2 unexpected error. 3 this acc
 the file or its folder. Every result ends with the line `settings file: <path>` on stdout.
 Python 3.6 or later.
 """
+
 import errno
 import json
 import os
@@ -43,7 +44,9 @@ def settings_path():
 
 def policy_home():
     # The override exists for this skill's tests alone.
-    if os.environ.get("BANKER_BYPASS_TEST") == "1" and os.environ.get("BANKER_BYPASS_POLICY_HOME"):
+    if os.environ.get("BANKER_BYPASS_TEST") == "1" and os.environ.get(
+        "BANKER_BYPASS_POLICY_HOME"
+    ):
         return os.environ["BANKER_BYPASS_POLICY_HOME"]
     return POLICY_HOMES.get(sys.platform, "/etc/claude-code")
 
@@ -59,7 +62,11 @@ ABSENT = (errno.ENOENT, errno.ENOTDIR, errno.EISDIR)
 
 
 def unreadable_policy(path):
-    return Refused("this machine's managed policy cannot be read (" + path + "); ask the administrator whether it allows the mode")
+    return Refused(
+        "this machine's managed policy cannot be read ("
+        + path
+        + "); ask the administrator whether it allows the mode"
+    )
 
 
 def policy_files():
@@ -73,7 +80,12 @@ def policy_files():
         if e.errno not in ABSENT:
             raise unreadable_policy(drop)
         names = []
-    files += [os.path.join(drop, n) for n in sorted(n for n in names if n.endswith(".json") and not n.startswith("."))]
+    files += [
+        os.path.join(drop, n)
+        for n in sorted(
+            n for n in names if n.endswith(".json") and not n.startswith(".")
+        )
+    ]
     return files
 
 
@@ -108,6 +120,7 @@ def load(path):
         raise Refused("settings.json is not valid UTF-8")
     if not text.strip():
         return {}, raw
+
     def reject(token):
         raise ValueError("the constant " + token + " is not JSON")
 
@@ -134,7 +147,9 @@ def replace(path, data, mode):
         except OSError as e:
             if e.errno not in (errno.EBUSY, errno.EXDEV):
                 raise
-            with open(path, "wb") as target:  # a bind-mounted single file refuses the rename: write in place
+            with open(
+                path, "wb"
+            ) as target:  # a bind-mounted single file refuses the rename: write in place
                 target.write(data)
             os.remove(tmp)
     except BaseException:
@@ -148,21 +163,34 @@ def save(path, data, raw):
     real = os.path.realpath(path)
     mode = os.stat(real).st_mode & 0o777 if os.path.exists(real) else 0o600
     bom = BOM if raw is not None and raw.startswith(BOM) else b""
-    replace(real, bom + (json.dumps(data, indent=2, ensure_ascii=False) + "\n").encode("utf-8"), mode)
+    replace(
+        real,
+        bom + (json.dumps(data, indent=2, ensure_ascii=False) + "\n").encode("utf-8"),
+        mode,
+    )
 
 
 def check_on(path, data):
     # Claude Code lets root use the mode inside a sandbox it recognises: IS_SANDBOX exactly "1", or
     # CLAUDE_CODE_BUBBLEWRAP set to a true value (2.1.289 reads 1, true, yes, on; 0 or false is not one).
-    bubblewrap = os.environ.get("CLAUDE_CODE_BUBBLEWRAP", "").strip().lower() in ("1", "true", "yes", "on")
+    bubblewrap = os.environ.get("CLAUDE_CODE_BUBBLEWRAP", "").strip().lower() in (
+        "1",
+        "true",
+        "yes",
+        "on",
+    )
     sandboxed = os.environ.get("IS_SANDBOX") == "1" or bubblewrap
     if hasattr(os, "geteuid") and os.geteuid() == 0 and not sandboxed:
-        raise Refused("Claude Code will not start in bypassPermissions as root; IS_SANDBOX=1 marks a real sandbox")
+        raise Refused(
+            "Claude Code will not start in bypassPermissions as root; IS_SANDBOX=1 marks a real sandbox"
+        )
     blocked = policy_block()
     if blocked:
         raise Refused("managed policy forbids bypassPermissions: " + blocked)
     if forbids(data):
-        raise Refused("settings.json itself sets permissions.disableBypassPermissionsMode")
+        raise Refused(
+            "settings.json itself sets permissions.disableBypassPermissionsMode"
+        )
 
 
 def forget_record(path):
@@ -176,7 +204,9 @@ def forget_record(path):
 
 def turn_on(path):
     if not os.path.isdir(os.path.dirname(path)):
-        raise Refused("there is no Claude Code config folder at " + os.path.dirname(path))
+        raise Refused(
+            "there is no Claude Code config folder at " + os.path.dirname(path)
+        )
     data, raw = load(path)
     check_on(path, data)
     if data.get("permissions", {}).get("defaultMode") == MODE:
@@ -197,13 +227,21 @@ def turn_off(path):
     data, raw = load(path)
     current = data.get("permissions", {}).get("defaultMode")
     if current != MODE:
-        print("defaultMode = " + str(current) + " (not bypassPermissions, nothing changed)")
+        print(
+            "defaultMode = "
+            + str(current)
+            + " (not bypassPermissions, nothing changed)"
+        )
         return 0
-    if not os.access(path, os.W_OK):  # a read-only settings file is a lock: off honours it as on does
+    if not os.access(
+        path, os.W_OK
+    ):  # a read-only settings file is a lock: off honours it as on does
         raise PermissionError(errno.EACCES, "this account may not write", path)
     del data["permissions"]["defaultMode"]
     save(path, data, raw)
-    forget_record(path)  # only after the write: if it failed, the record is still the way back
+    forget_record(
+        path
+    )  # only after the write: if it failed, the record is still the way back
     print("defaultMode removed (Claude Code's default start mode)")
     return 0
 
@@ -212,7 +250,10 @@ def outcome(argv, path):
     actions = {("on", "--yes"): turn_on, ("off",): turn_off}
     action = actions.get(tuple(argv[1:]))
     if action is None:
-        print("refused: usage is `bypass-permissions.py on --yes` or `bypass-permissions.py off`", file=sys.stderr)
+        print(
+            "refused: usage is `bypass-permissions.py on --yes` or `bypass-permissions.py off`",
+            file=sys.stderr,
+        )
         return 1
     try:
         return action(path)
@@ -221,12 +262,22 @@ def outcome(argv, path):
         return 1
     except OSError as e:
         if e.errno in (errno.EACCES, errno.EPERM, errno.EROFS):
-            print("write blocked: " + str(e) + "; settings.json left as it was", file=sys.stderr)
+            print(
+                "write blocked: " + str(e) + "; settings.json left as it was",
+                file=sys.stderr,
+            )
             return 3
         print("unexpected error: " + str(e) + "; check settings.json", file=sys.stderr)
         return 2
     except Exception as e:  # anything else stopped it partway too
-        print("unexpected error: " + type(e).__name__ + ": " + str(e) + "; check settings.json", file=sys.stderr)
+        print(
+            "unexpected error: "
+            + type(e).__name__
+            + ": "
+            + str(e)
+            + "; check settings.json",
+            file=sys.stderr,
+        )
         return 2
 
 

package/skills/smart-compact/SKILL.md

@@ -98,7 +98,7 @@ description: "컨텍스트 사용률이 임계(기본 50%)를 넘으면 `append_
 
 1~3은 어시스턴트가 자동 수행. 4는 유저가 실행한다. 안내는 2에서 끝내고 3 뒤에는 아무것도 붙이지 않는다.
 (Claude=`/banker:append_wiki`·`/banker:ready-compact`,
-Codex=`$banker-append_wiki`·`$banker-ready-compact`; `/copy`·compaction은 양쪽 TUI 내장.)
+Codex=`$banker-append_wiki`·`$banker-ready-compact`, 플러그인 설치면 `$banker:append_wiki`·`$banker:ready-compact`; `/copy`·compaction은 양쪽 TUI 내장.)
 
 ## 활성화 (idempotent · compose-safe)
 `smart-compact [--threshold N]` (기본 N=50). 아래는 Claude Code 절차이고, Codex 는 위 Codex 절의 `codex-gate.mjs on` 으로 대신한다:

package/skills/smart-compact/scripts/codex-gate.mjs

@@ -138,7 +138,8 @@ export const percent = (u) => Math.round((u.used * 100) / u.window);
 export function nudge(pct, threshold) {
   return `smart-compact: 컨텍스트 사용률 ${pct}% (임계 ${threshold}%). 이번 응답에서 위생 체인을 실행한다: `
     + "$banker-append_wiki, 그다음 한 줄 안내(다음 메시지가 resume 프롬프트이고 그 뒤 /copy, /compact, 붙여 넣기 순서), "
-    + "마지막으로 $banker-ready-compact. /copy, /compact, 붙여 넣기는 사용자가 한다.";
+    + "마지막으로 $banker-ready-compact. banker 를 Codex 플러그인으로 설치했으면 $banker:append_wiki, $banker:ready-compact 다. "
+    + "/copy, /compact, 붙여 넣기는 사용자가 한다.";
 }
 
 const text = (o, key) => (o && typeof o[key] === "string" ? o[key] : "");

package/skills/theme-selection/SKILL.md

@@ -24,7 +24,7 @@ argument-hint: "list | css | json | widget | check [--design-md PATH] [--only SL
    | 런타임 | 스킬 디렉터리 |
    |---|---|
    | Claude Code | 이 파일 맨 위에 넣어 준 "Base directory for this skill:" 줄의 경로 |
-   | Codex | `~/.codex/skills/banker-theme-selection/` 의 절대경로. 프로젝트 범위 설치면 `./.codex/skills/banker-theme-selection/` |
+   | Codex | Codex 스킬 목록이 보이는 이 SKILL.md 경로(file)의 폴더. npm 설치는 `~/.codex/skills/banker-theme-selection/`(프로젝트 범위 설치면 `./.codex/skills/banker-theme-selection/`), 플러그인 설치(`codex plugin add`)는 `~/.codex/plugins/cache/<마켓플레이스>/banker/<판>/skills/theme-selection/`. 절대경로로 씀 |
 
    - `~` 는 따옴표 안에서 펼쳐지지 않으니 절대경로를 쓴다.
 2. 프로젝트에 `DESIGN.md` 가 있으면 `--design-md` 로 함께 먹인다. 없으면 번들 74종만 쓴다.

package/skills/tone-compact/SKILL.md

@@ -24,7 +24,7 @@ argument-hint: "on | off | status"
    | 런타임 | `--runtime` | 스킬 디렉터리 |
    |---|---|---|
    | Claude Code | `claude` | 스킬 맨 위 "Base directory for this skill:" 경로 |
-   | Codex | `codex` | `~/.codex/skills/banker-tone-compact/` 의 절대경로. 프로젝트 범위 설치면 `./.codex/skills/banker-tone-compact/` |
+   | Codex | `codex` | Codex 스킬 목록이 보이는 이 SKILL.md 경로(file)의 폴더. npm 설치는 `~/.codex/skills/banker-tone-compact/`(프로젝트 범위 설치면 `./.codex/skills/banker-tone-compact/`), 플러그인 설치(`codex plugin add`)는 `~/.codex/plugins/cache/<마켓플레이스>/banker/<판>/skills/tone-compact/`. 절대경로로 씀 |
 
 3. 결과 처리
 

package/skills/tone-compact/scripts/instruction-toggle.mjs

@@ -186,7 +186,7 @@ export function writeFresh(file, data, mode = 0o644) {
   const tmp = `${file}.${process.pid}.tmp`;
   rmSync(tmp, { force: true });
   try {
-    writeFileSync(tmp, data, { flag: "wx", mode });
+    writeNew(tmp, data, mode);
     renameOver(tmp, file);
   } catch (e) {
     rmSync(tmp, { force: true });
@@ -194,6 +194,48 @@ export function writeFresh(file, data, mode = 0o644) {
   }
 }
 
+// Opens a file that is not there yet, as "wx" does, and makes sure the name is the file made. macOS and Linux refuse
+// any name that is there, a link to nothing among them (EEXIST). Windows follows a link to nothing and makes the file
+// it leads to: then that file is removed again when it is still the empty one made, and the open is refused with
+// EEXIST as elsewhere. A look before the open catches such a link; this catches one planted between the look and the
+// open. A look that fails after the open leaves the file to the caller, as a plain "wx" would.
+export function openNew(path, mode) {
+  const fd = openSync(path, "wx", mode);
+  let made = null;
+  let st;
+  try {
+    made = fstatSync(fd, { bigint: true });
+    st = lstatSync(path, { bigint: true });
+  } catch {
+    return fd;
+  }
+  if (!st.isSymbolicLink() && (made.ino === 0n || sameInode(made, st))) return fd;
+  closeSync(fd);
+  if (st.isSymbolicLink()) dropFollowed(path, made);
+  throw Object.assign(new Error(`EEXIST: file already exists, open '${path}'`), { code: "EEXIST", syscall: "open", path });
+}
+
+// Removes the file a "wx" open made through the link at path, when it is still the empty file that open made.
+function dropFollowed(path, made) {
+  try {
+    const target = realpathSync(path);
+    const st = statSync(target, { bigint: true });
+    if (sameInode(made, st) && st.size === 0n) rmSync(target, { force: true });
+  } catch {
+    // gone already, or the link changed again: nothing of ours to take back
+  }
+}
+
+// Writes data to a file that is not there yet (openNew) and closes it.
+function writeNew(path, data, mode) {
+  const fd = openNew(path, mode);
+  try {
+    writeFileSync(fd, data);
+  } finally {
+    closeSync(fd);
+  }
+}
+
 // Windows does not rename a file over a link to a folder: there the link goes first, and the folder it
 // leads to stays.
 function renameOver(tmp, file) {
@@ -510,13 +552,14 @@ function writeBlocked(changes) {
 // whatever the umask allows more. A file left empty is removed, unless it is a
 // link or has other names (a hard link), whose other names would keep the old
 // text: it is emptied instead. Codex skips an empty file anyway.
-// A file that was not there when it was read is created only if it still is not ("wx"): a name that appeared in
+// A file that was not there when it was read is created only if it still is not (openNew): a name that appeared in
 // between, a link planted there among them, is not written through.
 function apply(t, changes) {
   for (const { file, after } of changes) {
     if (file.bytes !== null) writeFresh(`${file.path}.${t.slug}.bak`, file.bytes, 0o600);
     if (after === "" && !isLink(file.path) && !hasOtherNames(file.path)) rmSync(file.path, { force: true });
-    else writeFileSync(file.path, after, { mode: 0o644, flag: file.bytes === null ? "wx" : "w" });
+    else if (file.bytes === null) writeNew(file.path, after, 0o644);
+    else writeFileSync(file.path, after, { mode: 0o644, flag: "w" });
   }
 }
 
@@ -568,9 +611,19 @@ const SLEEP = new Int32Array(new SharedArrayBuffer(4));
 // when it may still be there (no stats or no inode number to prove it is that file, or the share could not say).
 // Any other error (permissions, EIO) throws, after the same taking away.
 function tryLock(path, token) {
+  // A name that is there in any form is held. Windows opens "wx" through a link to nothing and makes the file it leads
+  // to; macOS and Linux answer EEXIST for it below, and openNew takes back a file Windows made through a link planted
+  // after this look. A look that fails leaves the answer to the open, as before.
+  let there = false;
+  try {
+    there = lstatSync(path, { throwIfNoEntry: false }) !== undefined;
+  } catch {
+    // ESTALE and the like: the open below answers
+  }
+  if (there) return "held";
   let fd;
   try {
-    fd = openSync(path, "wx", 0o600);
+    fd = openNew(path, 0o600);
   } catch (e) {
     if (e.code === "EEXIST") return "held";
     if (e.code === "ESTALE") return "stale";

package/skills/ultra-chain/SKILL.md

@@ -65,7 +65,7 @@ ultra-chain 이 직접 하는 일은 여섯 가지다.
 | 이어 하기 메모 | OMC 작업 노트에 덧붙이기(`notepad_write_working`). 우선 노트는 통째로 바뀌므로 쓰지 않음 | `.omx/notepad.md` 에 한 줄 덧붙이기 |
 | 실행 기록 기본 폴더 | `.omc/ultra-chain/` | `.omx/ultra-chain/` |
 
-- Codex 에는 Skill 도구가 없다. 위 표의 `$이름` 은 그 스킬의 `SKILL.md` 를 읽고 그대로 따른다는 뜻이다. banker 스킬은 `<S>/../banker-<이름>/SKILL.md`, OMX 스킬은 `~/.codex/skills/<이름>/SKILL.md` 다. 그 스킬이 상태 기록을 요구하면 그 지시대로 직접 기록한다. 큰 `SKILL.md`(ralph-qa 는 약 71KB)는 셸 출력 한도에서 잘리니 나눠 읽는다.
+- Codex 에는 Skill 도구가 없다. 위 표의 `$이름` 은 그 스킬의 `SKILL.md` 를 읽고 그대로 따른다는 뜻이다. banker 스킬은 npm 설치면 `<S>/../banker-<이름>/SKILL.md`, Codex 플러그인 설치(`<S>` 가 `plugins/cache/` 아래, 스킬 이름 `banker:<이름>`)면 `<S>/../<이름>/SKILL.md` 다. 표의 `$banker-<이름>` 은 플러그인 설치에서 `$banker:<이름>` 이다. OMX 스킬은 `~/.codex/skills/<이름>/SKILL.md` 다. 그 스킬이 상태 기록을 요구하면 그 지시대로 직접 기록한다. 큰 `SKILL.md`(ralph-qa 는 약 71KB)는 셸 출력 한도에서 잘리니 나눠 읽는다.
 - Codex 의 하위 에이전트(critic, 시각 판정)는 저자 대화를 넘기지 않는다. multi-agent v2 는 `fork_turns="none"` 을 주고, v1 은 `fork_context` 를 주지 않는다. 판정을 받으면 `close_agent` 로 닫는다.
 - Codex 환경 지시가 역할(`agent_type`)을 요구하면, 고정 모델이 세션 모델과 같은 역할을 쓰고 지시 앞머리에 파일 쓰기 금지를 적는다. 그런 역할이 없으면 역할 없이 띄운다. 쓴 역할과 모델, 강도를 판정 기록의 `note` 에 적는다.
 - Codex 의 오래 도는 명령은 기다리는 시간을 박스 `--timeout` 보다 길게 둔다. 기다리다 끊기면 박스 정리와 결과 JSON 이 남지 않는다.
@@ -424,7 +424,7 @@ node "<S>/references/chain-report.mjs" "<run>"
 
 압축(compaction)이나 중단 뒤에는 다음 순서로 잇는다.
 
-1. 이 스킬을 다시 부른다: `--run=<실행 폴더> --from=<단계>`(Claude Code `Skill("banker:ultra-chain")`, Codex `$banker-ultra-chain`). 지시와 `<S>` 를 되찾기 위해서다. 실행 폴더는 이어 하기 메모나 압축 요약에서 찾는다.
+1. 이 스킬을 다시 부른다: `--run=<실행 폴더> --from=<단계>`(Claude Code `Skill("banker:ultra-chain")`, Codex `$banker-ultra-chain`, 플러그인 설치면 `$banker:ultra-chain`). 지시와 `<S>` 를 되찾기 위해서다. 실행 폴더는 이어 하기 메모나 압축 요약에서 찾는다.
 2. `node "<S>/references/chain-ledger.mjs" show "<run>"` 로 `current`(다시 시작할 단계), 단계별 `lastVerdict`(마지막 판정과 blocker), `maxRound` 를 본다. 멈추거나 실패한 실행은 그 단계가 `current` 다. 원래 플래그는 `task.md` 첫 줄과 `preflight` 기록에 있다.
 3. 끊길 때 돌던 작업(박스 시험, 검토 좌석, 서버)이 끝났는지 확인한다. 끝나지 않았으면 알림을 기다리거나 멈춘다. 끊기기 전 실행의 늦은 판정은 쓰지 않는다.
 4. 돌던 ralph-qa 실행은 되살리지 않는다. 좌석과 끈끈한 반대는 한 실행 안에서만 유지되기 때문이다.

package/skills/ultra-ui-qa/SKILL.md

@@ -11,7 +11,7 @@ description: "웹 UI 를 Playwright 로 렌더해 디자인 원본(PDF 나 스
 ## 0. 전제조건: playwright (없으면 설치부터)
 이 스킬은 playwright 브라우저가 있어야 동작한다. **진행 전 설치 여부를 먼저 확인**하고, 없으면 **설치부터 안내**한다(추정·임의 재설치 금지):
 - 확인: `ls "${PLAYWRIGHT_BROWSERS_PATH:-$HOME/.cache/ms-playwright}" 2>/dev/null | grep -qi chromium && echo ok`
-- 미설치면 먼저 `setup-playwright` 스킬로 설치(Claude Code: `/banker:setup` → setup-playwright / Codex: `banker-setup-playwright`). 설치·검증 후 이 스킬을 이어서 진행한다.
+- 미설치면 먼저 `setup-playwright` 스킬로 설치(Claude Code: `/banker:setup` → setup-playwright / Codex: `banker-setup-playwright`, 플러그인 설치면 `banker:setup-playwright`). 설치·검증 후 이 스킬을 이어서 진행한다.
 
 ## When to use
 - "ultra ui qa", "UI 대조", "디자인 PDF와 대조", "내부개념/어색한 내용 점검", "표 title·차트 크기 비교"