@kaydash9999/banker-plugins 0.14.0 → 0.15.1

package/hooks/graceful-pause.mjs

@@ -0,0 +1,222 @@
+/**
+ * /graceful-pause [memo]: ask the running work to finish only its current step, stop,
+ * report and wait for instructions, without cutting it off the way Esc does.
+ *
+ * A skill or plugin command typed while a turn runs waits until the turn ends. This one
+ * is registered `immediate`, so it runs at once, mid-turn. It appends one user-role row
+ * the person does not see (`$.session.append`); the running turn reads it from its next
+ * model request on, that is once the tool call in flight returns.
+ *
+ * Two ways the note could land wrong are closed here:
+ *   - typed during the turn's last answer, no later request reads it, and the next
+ *     prompt's turn would read a stale pause first: when the turn ends unread and no
+ *     background work is left, a second row voids it;
+ *   - typed while idle with background work or a scheduled wake-up still pending, the
+ *     next notification or scheduled prompt would start the next step: the note goes out
+ *     as a prompt of its own instead, read as the person's (`asUser`), from a timer,
+ *     since the engine refuses a submission made inside the command's own hook (the
+ *     submission would wait on the dispatch that hook holds).
+ *
+ * The background count (tasks in flight plus scheduled wake-ups) is what the last Stop
+ * or SubagentStop reported. A turn cut off
+ * by Esc reports none, so the count can stay high until the next one: the note's last
+ * line covers that, as it tells the model to follow a newer prompt. The module's
+ * variables start over when the plugin reloads; a turn already running then reads as
+ * idle until the next one starts.
+ *
+ * Function hooks run inside the engine with no Node and no DOM: everything goes
+ * through `$`. `immediate` is checked on Claude Code 2.1.289; an older engine gets no
+ * command (it would wait for the turn to end, then answer "nothing to stop"). Codex
+ * has no function hooks.
+ */
+export const COMMAND = 'graceful-pause';
+export const MIN_ENGINE = [2, 1, 289];
+
+const SPEC = {
+  name: COMMAND,
+  description: '지금 단계만 끝내고 멈춘 뒤 보고하고 지시를 기다림. 작업 중에 입력해도 바로 전달',
+  argumentHint: '[멈춘 뒤 다룰 지시나 메모]',
+  immediate: true,
+};
+
+const IDLE = '진행 중인 작업이 없어 멈출 것이 없습니다. 지시를 바로 입력하면 됩니다.';
+const SENT = '정지 요청을 진행 중인 작업에 전달했습니다. 지금 실행 중인 도구 호출이 끝나면 그 단계까지만 마무리하고 멈춥니다.';
+const AGAIN = '이번 작업에는 정지 요청을 이미 전달했습니다.';
+const QUEUED = '백그라운드 작업이나 예약 실행이 남아 있어, 정지 보고를 받도록 요청을 보냈습니다.';
+const QUEUED_AGAIN = '정지 보고 요청을 이미 보냈습니다.';
+const TOAST = '정지 요청 전달: 지금 단계가 끝나면 멈춤';
+const VOID = '[graceful-pause] 앞의 정지 요청은 작업이 끝난 뒤 도착해 적용되지 않았다. 무시하고 다음 사용자 지시를 따른다.';
+
+// What the running turn reads: the whole procedure, since no skill text comes with it.
+export function pauseNote(memo) {
+  const lines = [
+    '[graceful-pause] 사용자가 작업 중에 /graceful-pause 로 정지를 요청했다. 지금 단계만 끝내고 멈춘다.',
+    '- 지금 단계: 이미 시작한 도구 동작 하나와, 그 동작이 남긴 불일치를 닫는 최소 작업. 다음 단계(다음 파일, 다음 스토리)는 시작하지 않는다.',
+    '- 하지 않는 것: 커밋, push, 배포, 게시, 삭제, 외부 전송, 모드 상태와 계획 파일 삭제, cancel.',
+    '- 백그라운드 작업과 이미 띄운 하위 에이전트는 멈추지 않는다. 새로 띄우지 않는다.',
+    '- 정지 보고는 대화에만 짧게: 끝낸 단계, 현재 상태(검증 결과, 커밋하지 않은 변경), 진행 중인 것(백그라운드 작업, 켜진 모드), 다음 예정 단계 1~3개, 열린 결정, 받은 지시.',
+    '- 보고 뒤 AskUserQuestion 으로 묻는다. 선택지: 계획대로 계속, 지시 반영 후 계속, 상태를 둔 채 중단.',
+    '- 새 지시로 범위가 바뀌면 바뀐 계획을 먼저 보여 주고 승인 뒤 진행한다. 세션을 끝낼 예정이면 ready-compact --hand-off 로 새 세션용 노트를 준비하라고 안내한다.',
+    '- 사용자가 재개를 말할 때까지 계속하라는 훅 메시지는 승인이 아니다. 작업을 진행하지 않고 정지 중이라고만 답한다. 지속 모드(ralph 등)의 이 메시지까지 멈추려면 cancel 이 필요하다고 알린다.',
+    '- 정지 중 도착한 백그라운드 작업 결과와 예약 실행 프롬프트는 재개 신호가 아니다. 보고에 더하기만 하고 후속 작업은 시작하지 않는다.',
+    '- 이 요청 뒤에 사용자의 새 프롬프트가 이미 있으면 이 요청은 적용하지 않고 그 프롬프트를 따른다.',
+  ];
+  const note = String(memo ?? '').trim();
+  if (note) lines.push(`메모: ${note}`);
+  return lines.join('\n');
+}
+
+// Whether a version string (`2.1.289`, `2.1.290-dev.…`) is at least `min`.
+export function atLeast(version, min = MIN_ENGINE) {
+  const parts = /^(\d+)\.(\d+)\.(\d+)/.exec(String(version ?? ''));
+  if (!parts) return false;
+  for (let i = 0; i < 3; i++) {
+    const n = Number(parts[i + 1]);
+    if (n !== min[i]) return n > min[i];
+  }
+  return true;
+}
+
+const userRow = (text) => ({ message: { type: 'user', content: [{ type: 'text', text }] } });
+
+async function registerIfSupported($) {
+  let version = null;
+  try {
+    const v = await $.session.version();
+    version = v?.base || v?.version || null;
+  } catch {
+    /* an engine without the call is older than the command needs */
+  }
+  if (!atLeast(version)) {
+    $.ui.log(`banker: /${COMMAND} 는 Claude Code ${MIN_ENGINE.join('.')} 이상에서만 켭니다 (이 엔진: ${version || '버전 미상'})`);
+    return;
+  }
+  try {
+    await $.command.register(SPEC);
+  } catch (err) {
+    $.ui.log(`banker: /${COMMAND} 를 등록하지 못했습니다 (${String(err?.message ?? err)})`);
+  }
+}
+
+// Appends the note to the running turn; the answer the command shows. The note counts
+// as sent before the call returns: a model request starting meanwhile reads the stored
+// row, and a second /graceful-pause meanwhile must not append another.
+async function deliver($, state, memo) {
+  if (state.pending?.turnId === state.main) return { text: AGAIN };
+  const pending = { turnId: state.main, afterStep: state.step, read: false };
+  state.pending = pending;
+  let res;
+  try {
+    res = await $.session.append(userRow(pauseNote(memo)));
+  } catch (err) {
+    res = { deny: String(err?.message ?? err) };
+  }
+  if (res?.deny) {
+    if (state.pending === pending) state.pending = null;
+    return { text: `정지 요청을 전달하지 못했습니다: ${res.deny}` };
+  }
+  $.ui.toast(TOAST);
+  return { text: SENT };
+}
+
+// Idle with background work or a scheduled wake-up pending: the note as a prompt of its
+// own, sent from a timer once the command has answered. A hook that drops the prompt
+// resolves `{ drop }` rather than rejecting.
+function queueReport($, state, memo) {
+  if (state.queued) return { text: QUEUED_AGAIN };
+  state.queued = true;
+  const failed = (why) => {
+    state.queued = false;
+    $.ui.log(`banker: /${COMMAND} 정지 보고 요청을 보내지 못했습니다 (${why})`);
+  };
+  $.clock.after(1, () => {
+    $.prompt.submit({ text: pauseNote(memo), asUser: true }).then(
+      (res) => res?.drop && failed(String(res.drop)),
+      (err) => failed(String(err?.message ?? err)),
+    );
+  });
+  return { text: QUEUED };
+}
+
+// At the main turn's end: a note no later request read is voided unless background
+// work will wake the session (the turn it starts reads the note then).
+async function settlePending($, state) {
+  const { pending } = state;
+  state.pending = null;
+  if (!pending || pending.read || state.background > 0) return;
+  try {
+    await $.session.append(userRow(VOID));
+  } catch {
+    /* nothing more to do: the log line below still tells the person */
+  }
+  $.ui.log('banker: /graceful-pause 요청이 작업 끝에 도착해 적용되지 않았습니다.');
+}
+
+// Nothing in flight: the state a fresh session, or one after /clear, starts from.
+const fresh = () => ({ main: null, step: -1, pending: null, background: 0, queued: false });
+const listed = (v) => (Array.isArray(v) ? v.length : 0);
+const backgroundCount = (e) => listed(e.background_tasks) + listed(e.session_crons);
+
+export function registerGracefulPause(on) {
+  // The main turn in flight and its latest model request; subagent loops raise no
+  // turn.start and end with an agentId. `queued`: a report prompt not started yet.
+  const state = fresh();
+  watchSession(on, state);
+  watchTurns(on, state);
+
+  on('command.run', { command: COMMAND }, async ($, e) => {
+    if (state.main) return deliver($, state, e.args);
+    if (state.background > 0) return queueReport($, state, e.args);
+    return { text: IDLE };
+  });
+}
+
+// The command's registration, a fresh state after /clear, and the background count the
+// stop events report.
+function watchSession(on, state) {
+  on('session.start', async ($, e, next) => {
+    await registerIfSupported($);
+    return next(e);
+  });
+
+  // `/clear` ends the conversation and raises no session.start for the next one.
+  on('session.end', async ($, e, next) => {
+    Object.assign(state, fresh());
+    return next(e);
+  });
+
+  on('classic.Stop', async ($, e, next) => {
+    state.background = backgroundCount(e);
+    return next(e);
+  });
+
+  on('classic.SubagentStop', async ($, e, next) => {
+    state.background = backgroundCount(e);
+    return next(e);
+  });
+}
+
+// The main turn in flight and the model requests it makes. turn.step wraps every
+// request's stream, subagents' too: in the engine's kit that cost 25 to 45 µs a chunk,
+// well under 1% of a request.
+function watchTurns(on, state) {
+  on('turn.start', async ($, e, next) => {
+    Object.assign(state, { main: e.turnId, step: -1, queued: false });
+    return next(e);
+  });
+
+  on('turn.step', async function* ($, e, next) {
+    if (e.turnId === state.main) {
+      state.step = e.index;
+      if (state.pending?.turnId === e.turnId && e.index > state.pending.afterStep) state.pending.read = true;
+    }
+    return yield* next(e);
+  });
+
+  on('turn.complete', async ($, e, next) => {
+    if (e.agentId || e.turnId !== state.main) return next(e);
+    state.main = null;
+    await settlePending($, state);
+    return next(e);
+  });
+}

package/hooks/hooks.json

@@ -1,5 +1,6 @@
 {
-  "description": "banker hooks: obsidizer wiki canonicalization (PostToolUse, inert until `obsidizer --enable`) + anonymous usage counting (PostToolUse Skill / UserPromptExpansion, count-default-on, opt-out BANKER_NO_TELEMETRY, no-op without endpoint) + update-check notification (SessionStart, opt-out BANKER_NO_UPDATE_CHECK).",
+  "description": "banker hooks: obsidizer wiki canonicalization (PostToolUse, inert until `obsidizer --enable`) + anonymous usage counting (PostToolUse Skill / UserPromptExpansion, count-default-on, opt-out BANKER_NO_TELEMETRY, no-op without endpoint) + update-check notification (SessionStart, opt-out BANKER_NO_UPDATE_CHECK). modules: function hooks (Claude Code 2.1.289+) serving /graceful-pause, which runs at once even mid-turn.",
+  "modules": ["./register.mjs"],
   "hooks": {
     "PostToolUse": [
       {

package/hooks/register.mjs

@@ -0,0 +1,12 @@
+/**
+ * banker's function-hooks module: the one file hooks/hooks.json names under
+ * `modules`. Claude Code loads it beside the classic hooks in the same file;
+ * builds without function hooks, and Codex, leave it alone.
+ *
+ * Each feature registers its own hooks; this file only gathers them.
+ */
+import { registerGracefulPause } from './graceful-pause.mjs';
+
+export const register = (on) => {
+  registerGracefulPause(on);
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaydash9999/banker-plugins",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "description": "banker — Claude Code + Codex CLI plugin (QA, audit, docs, architecture, wiki skills). Install via Claude Code marketplace, or `npm i -g @kaydash9999/banker-plugins` then `banker setup`.",
   "bin": {
     "banker": "bin/banker.js"
@@ -15,10 +15,13 @@
     "!skills/ultra-init-workspace/**",
     "commands",
     ".claude-plugin",
+    "!.claude-plugin/types",
+    "!.claude-plugin/types/**",
     "codex",
     "hooks",
     "bin",
     "!**/*.test.mjs",
+    "!**/*.test.ts",
     "!**/test_*.py",
     "!**/__pycache__",
     "!**/__pycache__/**",

package/skills/3d-intro-build/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: 3d-intro-build
-description: "(banker) 브랜드 인트로용 스크롤-스크럽 3D fly-through 사이트를 Azure(gpt-image-2 스틸 + Sora-2 forward-chaining)로 제작: 인터뷰 → 비용 승인 게이트 → 스틸 → fly-through → 로컬 프리뷰. '3d-intro-build'/'3D 인트로'/'스크롤 fly-through'/'인트로 영상 사이트' 시 사용."
+description: "스크롤 위치에 맞춰 3D 플라이스루 영상이 움직이는 브랜드 인트로 사이트를 만듦. Azure 의 gpt-image-2 로 스틸을, Sora-2 로 영상을 생성. 인터뷰 뒤에 비용 승인 게이트에서 사용자가 승인해야만 유료 생성을 시작하고, 스틸, 영상, 로컬 프리뷰 순서로 진행. '3d-intro-build'/'3D 인트로'/'스크롤 fly-through'/'인트로 영상 사이트' 시 사용."
 ---
 
 # 3d-intro-build — 스크롤-스크럽 3D 인트로 제작 (Azure 파이프라인)

package/skills/3d-intro-setup/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: 3d-intro-setup
-description: "(banker) Azure Sora-2/gpt-image-2 3D 인트로 제작용 크레덴셜·의존성 설치: Node≥18·ffmpeg 확보 + apikey/엔드포인트/배포명 직접입력 또는 콘솔 샘플 코드 붙여넣기로 크레덴셜 저장 + 무과금 프리플라이트(listVideos·images badreq)로 검증. 'setup-3d-intro'/'3d-intro-setup'/'3D 인트로 설정'/'Azure Sora 크레덴셜' 또는 /banker:setup 시 사용."
+description: "`3d-intro-build` 에 필요한 Node 18 이상과 ffmpeg 를 갖추고 Azure 크레덴셜을 저장함. 크레덴셜은 직접 입력하거나 Azure 콘솔의 샘플 코드를 붙여 넣어 받고, 무과금 프리플라이트로 확인. 'setup-3d-intro'/'3d-intro-setup'/'3D 인트로 설정'/'Azure Sora 크레덴셜' 또는 `/banker:setup` 시 사용."
 ---
 
 # 3d-intro-setup — Azure Sora-2 / gpt-image-2 3D 인트로 제작 전제조건 설치

package/skills/all-in-one/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: all-in-one
-description: "(banker) 한 명령으로 합의 계획→검증 구현→독립 QA 게이트를 연쇄(ralplan→ralph→QA 게이트: Claude Code는 verify 순환, Codex는 ultraqa). 코딩 작업을 계획부터 통과까지 최대 rigor로 한 번에. 'all-in-one'/'all in one' 시 사용(한 줄 수정은 ralph, 아이디어 확장은 autopilot)."
+description: "코딩 작업을 한 명령으로 계획부터 QA 통과까지 엄격하게 진행. `ralplan` 으로 합의 계획, `ralph` 로 검증 구현을 하고 독립 QA 게이트(Claude Code 는 `verify` 순환, Codex 는 `ultraqa`)로 마무리. 'all-in-one'/'all in one' 시 사용. 한 줄 수정은 이 스킬 대신 `ralph`, 아이디어 확장은 `autopilot`."
 argument-hint: "[--short] [--checkpoint] [--critic=critic|architect|codex] [--qa=tests|build|lint|typecheck] [--no-deslop] <task description>"
 level: 4
 ---

package/skills/append_wiki/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: append_wiki
-description: "(banker) 새로 배운 비자명 지식을 .omc/wiki에 구조화 적재·병합. 'append_wiki'/'위키 기록'/'wiki에 정리'/'알게 된 내용 기록' 시 사용."
+description: "새로 알게 된 비자명한 지식을 `.omc/wiki` 에 구조화해 넣고 기존 페이지와 병합. 'append_wiki'/'위키 기록'/'wiki에 정리'/'알게 된 내용 기록' 시 사용."
 ---
 
 # append_wiki — 작업 지식을 wiki에 적재

package/skills/arch-diagram/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: arch-diagram
-description: "(banker) 시스템 아키텍처 구성도를 PlantUML과 편집 가능 PPTX로 산출. '아키텍처 다이어그램'/'plantuml'/'pptx 다이어그램'/'구성도' 시 사용."
+description: "시스템 아키텍처 구성도를 PlantUML과 편집 가능 PPTX로 산출. '아키텍처 다이어그램'/'plantuml'/'pptx 다이어그램'/'구성도' 시 사용."
 ---
 
 # arch-diagram — PlantUML + PPTX 아키텍처 다이어그램 산출

package/skills/audit-mock/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: audit-mock
-description: "(banker) 하드코딩·mock/stub·열거형을 read-only 정적 감사로 검출. 'audit-mock'/'하드코딩 검출'/'mock·stub 감사'/'SQL 없이 하드코딩 반환' 시 사용."
+description: "하드코딩된 값, mock, stub, 열거형을 정적 감사로 검출. 코드는 읽기만 함. 'audit-mock'/'하드코딩 검출'/'mock 감사'/'stub 감사'/'SQL 없이 하드코딩 반환' 시 사용."
 ---
 
 # audit-mock — 하드코딩 / mock·stub / 열거형 read-only 정적 감사

package/skills/audit-security/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: audit-security
-description: "(banker) 의존성 CVE(SCA)·SAST·시크릿을 멀티툴 교차검증으로 read-only 보안 진단. 'audit-security'/'보안 진단'/'CVE 스캔'/'SCA·SAST·secret 스캔' 시 사용."
+description: "의존성 CVE(SCA), 코드 정적 분석(SAST), 시크릿 노출을 여러 도구로 교차 검증해 보안을 진단. 코드는 읽기만 함. 'audit-security'/'보안 진단'/'CVE 스캔'/'SCA 스캔'/'SAST 스캔'/'secret 스캔' 시 사용."
 ---
 
 # audit-security — CVE / SAST / Secrets read-only 보안 진단 (no-root)

package/skills/audit-web-page/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: audit-web-page
-description: "(banker) 가동 중 웹페이지를 playwright로 라이브 점검(버튼·DOM·콘솔 + WebGL/Canvas 스크린샷 판정). 'audit-web-page'/'라이브 웹 검증'/'playwright로 페이지 점검'/'캔버스·WebGL 렌더 확인' 시 사용."
+description: "가동 중인 웹 페이지를 Playwright 로 열어 버튼, DOM, 콘솔을 라이브 점검하고, WebGL 과 Canvas 는 스크린샷으로 판정. 'audit-web-page'/'라이브 웹 검증'/'playwright로 페이지 점검'/'캔버스 렌더 확인'/'WebGL 렌더 확인' 시 사용."
 ---
 
 # audit-web-page — 라이브 웹 페이지 점검 (playwright)

package/skills/cleansing-memory/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cleansing-memory
-description: "(banker) 에이전트 메모리 파일(MEMORY.md·CLAUDE.md·AGENTS.md)을 문서화된 threshold 안으로 정리: 중복 최신본화, 무손실 간결화, append→replace 판별. 'cleansing-memory'/'메모리 정리'/'MEMORY.md 정리'/'CLAUDE.md 압축'/'AGENTS.md 용량' 시 사용."
+description: "에이전트 메모리 파일(`MEMORY.md`, `CLAUDE.md`, `AGENTS.md`)을 문서화된 기준치 안으로 정리. 중복은 최신본만 남기고, 무손실로 압축하고, 덧붙이지 말고 바꿔 써야 할 정보를 가려냄. 'cleansing-memory'/'메모리 정리'/'MEMORY.md 정리'/'CLAUDE.md 압축'/'AGENTS.md 용량' 시 사용."
 ---
 
 # cleansing-memory: 메모리 파일 정리 (중복 최신본화·무손실 압축·replace 판별)

package/skills/compact-copy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: compact-copy
-description: "(banker) 코드펜스로 감싼 resume 프롬프트(이전 형식 ready-compact 출력 등)에서 본문만 뽑아 최종 메시지를 '프롬프트-only'로 출력(response.md 기록 → /copy로 클립보드에 담김). 지금의 ready-compact 는 처음부터 프롬프트만 출력하므로 보통은 필요 없음. 'compact-copy'/'프롬프트만 복사'/'resume 프롬프트만' 시 사용."
+description: "코드펜스로 감싼 resume 프롬프트에서 본문만 뽑아 최종 메시지로 출력. `/copy` 한 번으로 클립보드에 담김. 지금의 `ready-compact` 는 처음부터 프롬프트만 출력하므로 보통은 필요 없음. 'compact-copy'/'프롬프트만 복사'/'resume 프롬프트만' 시 사용."
 ---
 
 # compact-copy — resume 프롬프트만 추출 복사

package/skills/compact-wiki/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: compact-wiki
-description: "(banker) .omc/wiki 페이지를 무손실로 중복 제거·supersede·병합 정리. 'compact-wiki'/'위키 정리·압축'/'wiki 중복 제거'/'위키 병합' 시 사용."
+description: "`.omc/wiki` 페이지를 무손실로 정리. 중복은 지우고, 낡은 내용은 새 내용으로 대체하고, 겹치는 페이지는 병합. 'compact-wiki'/'위키 정리'/'위키 압축'/'wiki 중복 제거'/'위키 병합' 시 사용."
 ---
 
 # compact-wiki — wiki 정리·압축 (무손실)

package/skills/curation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: curation
-description: "(banker) 의사결정을 {선택지·권고안·근거·확신수준(0.00~1.00)·확신근거}로 구조화해 제시. --perf는 결과물 품질·완성도를 효율보다 우선. --deep은 --perf에 더해 확신 0.80 이하 결정을 추가 조사·검토해 0.80 초과로 끌어올린 뒤 제시(끝내 못 넘으면 확신 미달로 표시하고 사용자 질문으로 전환). 'curation'/'큐레이션'/'결정 정리'/'선택지 정리' 시 사용."
+description: "의사결정을 선택지, 권고안, 근거, 확신 수준(0.00~1.00), 확신 근거로 정리해 제시. `--perf` 는 효율보다 결과물의 품질과 완성도를 우선. `--deep` 은 `--perf` 에 더해 확신 0.80 이하인 결정을 더 조사하고 검토해 0.80 을 넘긴 뒤 제시. 끝내 못 넘으면 확신 미달로 표시하고 사용자에게 물음. 'curation'/'큐레이션'/'결정 정리'/'선택지 정리' 시 사용."
 ---
 
 # curation — 결정 큐레이션 (선택지·권고·확신)

package/skills/deep-init/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: deep-init
-description: "(banker) 코드베이스 전체에 계층형 AGENTS.md 문서를 생성·갱신(부모 역참조·MANUAL 섹션 보존). 'deep-init'/'deepinit'/'AGENTS.md 생성'/'코드베이스 문서화' 시 사용."
+description: "코드베이스 전체에 계층형 `AGENTS.md` 문서를 만들거나 갱신. 상위 문서 참조와 `MANUAL` 섹션은 보존. 'deep-init'/'deepinit'/'AGENTS.md 생성'/'코드베이스 문서화' 시 사용."
 ---
 
 # deep-init — 계층형 AGENTS.md 초기화

package/skills/deep-research/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: deep-research
-description: "(banker) 다중 소스 웹 리서치를 팬아웃해 주장을 적대적으로 팩트체크하고 확신순 인용 리포트로 합성. 'deep-research'/'딥리서치'/'심층 조사'/'출처 검증 리서치' 시 사용."
+description: "여러 출처를 병렬로 웹 리서치해 주장을 적대적으로 팩트체크하고, 확신 순으로 인용한 리포트로 합성. 'deep-research'/'딥리서치'/'심층 조사'/'출처 검증 리서치' 시 사용."
 ---
 
 # deep-research — 팬아웃 + 적대적 검증 리서치

package/skills/docs-setup/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: docs-setup
-description: "(banker) arch-diagram·pdf-vision-extract 의존성(python-pptx·pymupdf·plantuml)을 python 환경 감지/선택 후 설치. 'docs-setup'/'문서 툴 설치'/'pptx·pymupdf·plantuml 설치' 또는 /banker:setup 시 사용."
+description: "`arch-diagram` 과 `pdf-vision-extract` 의 의존성(python-pptx, pymupdf, plantuml)을 설치. Python 환경을 감지하거나 고른 뒤 그 환경에 설치. 'docs-setup'/'문서 툴 설치'/'pptx 설치'/'pymupdf 설치'/'plantuml 설치' 또는 `/banker:setup` 시 사용."
 ---
 
 # docs-setup — 문서 생성 툴 설치 (python-pptx·pymupdf·plantuml)

package/skills/humanizer/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: humanizer
 version: 2.8.0
-description: "(banker) AI가 쓴 듯한 영문 글의 흔적을 제거해 자연스러운 문체로 윤문. 'humanizer'/'remove AI writing'/'sound more human'/'natural' 시 사용."
+description: "AI가 쓴 듯한 영문 글의 흔적을 제거해 자연스러운 문체로 윤문. 'humanizer'/'remove AI writing'/'sound more human'/'natural' 시 사용."
 license: MIT
 compatibility: claude-code opencode
 allowed-tools:

package/skills/interval-report/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: interval-report
-description: "(banker) 장기 수행의 중간 보고를 docs/intermission.md 로 만들고 계획된 작업이 끝날 때까지 갱신. 시작 시각은 date 로 실측해 파일에 영속하고, ETA 는 단일 숫자 대신 범위+확신 라벨로 낸다. 'interval-report'/'중간 보고'/'진행 상황 보고'/'intermission' 시 사용."
+description: "오래 걸리는 작업의 중간 보고를 `docs/intermission.md` 로 만들고 계획한 작업이 끝날 때까지 갱신. 시작 시각은 `date` 로 재서 파일에 남기고, ETA 는 단일 숫자 대신 범위와 확신 라벨로 냄. 'interval-report'/'중간 보고'/'진행 상황 보고'/'intermission' 시 사용."
 ---
 
 # interval-report: 장기 수행 중간 보고 (docs/intermission.md)