z2o-cli 0.4.1 → 0.7.0

package/README.md

@@ -4,7 +4,7 @@
 
 ```bash
 npm i -g z2o-cli
-z2o init z2o_live_...       # 설정 → 「팀 · 연결」에서 발급한 열쇠
+z2o init z2o_live_...       # z2o.kr 프로필 → 「연결 토큰」에서 발급한 열쇠
 ```
 
 `init` 이 세 가지를 한 번에 한다 — **로그인 · 워크스페이스 지정 · AI 규칙 파일에 사용법 심기.**
@@ -30,6 +30,19 @@ z2o find 계약               # 원본에서 찾기
 Claude Code·Cursor·Codex 등 **셸을 쓸 수 있는 AI라면 무엇에서든** 된다.
 MCP 와 달리 앱마다 연동 설정이 필요 없고, 토큰이 만료되지 않아 한 번 연결해 두면 계속 이어진다.
 
+## Claude Code 스킬 — `/z2o:read` · `/z2o:ingest`
+
+`init` 은 Claude Code 가 깔려 있으면 **스킬 둘**도 `~/.claude/skills/z2o/` 에 넣는다.
+
+| | 언제 |
+|---|---|
+| `/z2o:read` | 회사 맥락을 찾아 답할 때 — 슬랙·회의록·위키 |
+| `/z2o:ingest` | 자료를 위키에 넣고 정리할 때 — 넣기 → 뼈대 → 관련 문서 고쳐 쓰기 |
+
+직접 불러도 되고, **그냥 "이거 위키에 정리해"라고 말해도** Claude 가 알아서 꺼내 쓴다.
+평소에는 설명 한 줄(약 90토큰)만 들고 있다가 쓸 때 본문을 읽는다.
+새 판으로 올린 뒤에는 `z2o skills` 로 스킬만 바꿔 끼운다.
+
 ## 명령
 
 | | |
@@ -47,7 +60,12 @@ MCP 와 달리 앱마다 연동 설정이 필요 없고, 토큰이 만료되지
 | `z2o recent [개수]` | **정리 전 원본** — 슬랙·메일이 들어온 그대로 |
 | `z2o find <낱말>` | 원본에서 찾기 |
 | `z2o raw <id...>` | 원본 본문 |
+| `z2o rules` | 이 워크스페이스의 위키 규칙 — 쓰기 전에 먼저 |
+| `z2o skills` | Claude Code 스킬 설치·갱신 |
 | `z2o push <제목> <파일\|-\>` | 자료 넣기 — **쓰기 토큰 필요** |
+| `z2o build` | 원문·장부·표 만들기 (코드만, 0원) |
+| `z2o pending` | 요약이 필요한 원본 |
+| `z2o write <경로> <파일\|-\>` | 요약을 위키에 남기기 — **쓰기 토큰 필요** |
 | `z2o organize` | 정리 돌리기 — **쓰기 토큰 필요** |
 
 `-c <id>` 로 워크스페이스를 그때만 바꿀 수 있다.

package/index.js

@@ -14,9 +14,10 @@
  *    이쪽 설치가 무거우면 만든 이유가 없어진다.
  */
 
-import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync } from 'node:fs';
+import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync, cpSync, rmSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const DEFAULT_API = 'https://z2o.kr/_/backend';
 // 발급되는 토큰의 모양. `z2o_live_` + base64url.
@@ -147,6 +148,36 @@ function needCompany(flags) {
 
 // 🌍 **도구마다 「모든 폴더에 적용되는」 규칙 파일 자리가 따로 있다.**
 //    여기 한 번 심으면 폴더마다 `init` 을 돌릴 필요가 없다.
+// 🧩 **Claude Code 에는 스킬로도 심는다** — `/z2o:read` · `/z2o:ingest`.
+//    규칙 파일 블록은 **모든 대화에 항상** 실리지만, 스킬은 한 줄 설명(~90토큰)만 늘 들고
+//    본문은 **부를 때만** 읽힌다. 그래서 절차를 길고 정확하게 적을 수 있다.
+//    `~/.claude/skills/<이름>/` 에 두면 마켓플레이스 없이 다음 세션부터 `z2o@skills-dir` 로 뜬다.
+//    ⚠️ 규격은 서버(`z2o rules`), **순서는 스킬** — 회사마다 다른 것을 패키지에 박지 않는다.
+const PLUGIN_SRC = join(dirname(fileURLToPath(import.meta.url)), 'plugin');
+
+function installPlugin() {
+  const home = join(homedir(), '.claude');
+  if (!existsSync(home) || !existsSync(PLUGIN_SRC)) return null;
+  const dest = join(home, 'skills', 'z2o');
+  const mine = join(dest, '.claude-plugin', 'plugin.json');
+  if (existsSync(dest)) {
+    // 같은 이름의 **남의 것**은 덮지 않는다.
+    let ours = false;
+    try { ours = JSON.parse(readFileSync(mine, 'utf8')).name === 'z2o'; } catch { /* 없음 */ }
+    if (!ours) return { dest, state: '건너뜀 — 같은 이름의 다른 폴더가 있어요' };
+    rmSync(dest, { recursive: true, force: true });   // 옛 판의 지운 스킬이 남지 않게
+  }
+  mkdirSync(join(home, 'skills'), { recursive: true });
+  cpSync(PLUGIN_SRC, dest, { recursive: true });
+  return { dest, state: '설치' };
+}
+
+function reportPlugin(r = installPlugin()) {
+  if (!r) return;
+  console.log(`~/.claude/skills/z2o — ${r.state}`);
+  if (r.state === '설치') console.log('  Claude Code 스킬 /z2o:read · /z2o:ingest (다음 세션부터, 지금은 /reload-plugins)');
+}
+
 const GLOBAL_RULES = [
   ['.claude', 'CLAUDE.md'],
   ['.codex', 'AGENTS.md'],
@@ -164,27 +195,20 @@ const BLOCK = `${MARK_START}
 
 슬랙·회의록·위키를 \`z2o\` 명령으로 꺼낸다. **사람에게 복사해 달라고 하지 않는다.**
 
-| 정리 전 원본 | |
-|---|---|
-| \`z2o recent\` | 최근 들어온 것 (슬랙·메일) |
-| \`z2o find <낱말>\` | 원본에서 찾기 |
-| \`z2o raw <id>\` | 원본 본문 |
-
-| 정리된 위키 | |
-|---|---|
-| \`z2o search <낱말>\` | 본문 검색 |
-| \`z2o read <경로>\` | 문서 본문 |
-| \`z2o list [접두어]\` | 문서 목록 |
+| 정리 전 원본 | | 정리된 위키 | |
+|---|---|---|---|
+| \`z2o recent\` | 최근 들어온 것 | \`z2o search <낱말>\` | 본문 검색 |
+| \`z2o find <낱말>\` | 원본에서 찾기 | \`z2o read <경로>\` | 문서 본문 |
+| \`z2o raw <id>\` | 원본 본문 | \`z2o list [접두어]\` | 문서 목록 |
 
 **정리를 부탁받으면 내가 한다** — Z2O 의 AI 에게 맡기지 않는다.
 
-| | |
-|---|---|
-| \`z2o push <제목> <파일>\` | 원본 넣기. 장부·표는 코드가 알아서 만든다 |
-| \`z2o pending\` | 요약이 필요한 원본 |
-| \`z2o write <경로> <파일>\` | 관련 문서를 읽고 고쳐 쓴 요약을 남긴다 |
+🔑 **위키에 무엇을 쓰기 전에 \`z2o rules\` 를 먼저 읽고 그대로 따른다.**
+축 구성·문서 형식·건드리지 않을 곳·정리 순서가 거기 있다. **회사마다 다르고
+사용자가 고쳐 두었을 수 있으므로, 이 블록의 기억에 의존하지 않는다.**
 
-자세한 것은 \`z2o --help\`.
+Claude Code 에서는 스킬 \`/z2o:read\` · \`/z2o:ingest\` 가 순서를 담고 있다.
+자세한 명령은 \`z2o --help\`.
 ${MARK_END}`;
 
 /** 규칙 파일에 블록을 심는다. **두 번 해도 하나만 남는다.** */
@@ -250,7 +274,10 @@ const HELP = `z2o — 회사 온톨로지를 내가 쓰는 AI에서 꺼내 쓴
   z2o raw <id...>              원본 본문 (id 는 recent·find 가 준 것)
 
   ── 정리를 내 AI 가 한다 ──  (쓰기 토큰 필요)
-  z2o push <제목> <파일|->     원본 넣기 — 장부·표는 코드가 알아서 만든다
+  z2o rules                   이 워크스페이스의 위키 규칙 — **쓰기 전에 먼저**
+  z2o skills                  Claude Code 스킬 설치·갱신 (/z2o:read · /z2o:ingest)
+  z2o push <제목> <파일|->     원본 넣기
+  z2o build                   원문·장부·표 만들기 (코드만, 0원)
   z2o pending                 요약이 필요한 원본
   z2o write <경로> <파일|->    요약을 위키에 남기기 (예: topics/물류.md)
   z2o organize                Z2O 의 AI 에게 정리를 맡긴다 (직접 안 쓸 때)
@@ -334,6 +361,7 @@ const COMMANDS = {
         console.log(`~/${d}/${f} — ${r.state}`);
       }
       console.log('  (모든 폴더에서 통합니다)');
+      reportPlugin();
       console.log('\n이제 AI 에게 그냥 물어보세요:');
       console.log('  "최근 슬랙에서 나온 얘기 정리해줘"');
       if (needPick) {
@@ -357,6 +385,7 @@ const COMMANDS = {
     console.log(
       '  (다른 도구를 쓰면 그 도구의 규칙 파일을 만들어 두고 `z2o init` 을 다시 돌리세요)',
     );
+    reportPlugin();
 
     // ⚠️ **다 된 것처럼 끝내지 않는다.** 워크스페이스를 못 정했으면 아직 아무것도 안 된다 —
     //    여기서 "이제 물어보세요" 라고 하면 사람은 됐다고 믿고 넘어간다.
@@ -371,6 +400,13 @@ const COMMANDS = {
     void flags;
   },
 
+  // 스킬만 깔거나 새 판으로 바꾼다 — 토큰이 없어도 된다. `npm i -g z2o-cli` 로 올린 뒤에 한 번.
+  async skills() {
+    const r = installPlugin();
+    if (!r) die('Claude Code 가 안 보여요(~/.claude 없음). Claude Code 를 한 번 실행한 뒤 다시 해 주세요.');
+    reportPlugin(r);
+  },
+
   async logout() {
     const conf = loadConf();
     delete conf.token;
@@ -504,6 +540,24 @@ const COMMANDS = {
     );
   },
 
+  /** 이 워크스페이스의 규칙. **위키에 무엇을 쓰기 전에 먼저 본다.**
+   *
+   * 🔑 규칙을 규칙 파일에 통째로 적지 않는 이유 — 사용자가 지워도 아무도 모르고,
+   *    무엇보다 **회사마다 다를 수 없다.** 정본은 서버의 위키 문서 한 장이다.
+   */
+  async rules(_args, flags) {
+    console.log(await callTool('get_rules', { company_id: needCompany(flags) }));
+  },
+
+  /** 코드가 만드는 것만 — 원문·장부·거래처·표. **LLM 을 안 쓴다.**
+   *
+   * 🔑 `push` 뒤에 이걸 불러야 `docs/` 원문 문서가 생긴다. 안 부르면 요약에 건
+   *    링크가 깨진 채로 남는다.
+   */
+  async build(_args, flags) {
+    console.log(await callTool('build_skeleton', { company_id: needCompany(flags) }));
+  },
+
   async organize(_args, flags) {
     console.log(await callTool('organize', { company_id: needCompany(flags) }));
   },
@@ -511,6 +565,12 @@ const COMMANDS = {
 
 // ── 진입점 ──────────────────────────────────────────────
 
+if (['--version', '-v', 'version'].includes(process.argv[2])) {
+  const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), 'package.json'), 'utf8'));
+  console.log(pkg.version);
+  process.exit(0);
+}
+
 const { flags, rest } = parseArgs(process.argv.slice(2));
 const [cmd, ...args] = rest;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "z2o-cli",
-  "version": "0.4.1",
+  "version": "0.7.0",
   "description": "제로투원 — 회사 온톨로지와 슬랙 맥락을 내가 쓰는 AI에서 꺼내 쓴다",
   "keywords": [
     "z2o",
@@ -24,7 +24,8 @@
   },
   "files": [
     "index.js",
-    "README.md"
+    "README.md",
+    "plugin/"
   ],
   "engines": {
     "node": ">=18"

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
+  "name": "z2o",
+  "version": "0.7.0",
+  "description": "제로투원 — 회사 위키·슬랙·회의록을 읽고(/z2o:read) 위키에 정리해 넣는다(/z2o:ingest). z2o CLI 를 감싼다.",
+  "author": {
+    "name": "Lindy Operation"
+  },
+  "homepage": "https://z2o.kr",
+  "keywords": ["z2o", "zerotoone", "wiki", "ontology", "slack"]
+}

package/plugin/skills/ingest/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: ingest
+description: 자료를 제로투원 위키에 넣고 정리할 때 쓴다 — "이거 위키에 올려", "회의록 z2o 에 정리해", "pending 정리해", "온톨로지 정리해", "슬랙 들어온 거 요약해 둬". 원본을 넣고, 관련 문서를 찾아 읽고, 고쳐 쓴 요약을 남긴다. Z2O 의 AI(organize)에 맡기지 않고 내가 한다.
+allowed-tools:
+  - Bash(z2o *)
+  - Bash(mktemp *)
+  - Read
+  - Write
+---
+
+# /z2o:ingest — 위키에 정리해 넣기
+
+**정리는 내가 한다.** `z2o organize`(Z2O 의 AI)는 사람이 그렇게 해 달라고 할 때만 부른다.
+
+요청: `$ARGUMENTS`
+
+## 0. 규칙부터 — 매번
+
+```
+z2o rules
+```
+
+축 구성·문서 형식·건드리지 않을 곳이 거기 있다. **회사마다 다르고 사람이 고쳐 두었을 수 있다.**
+이 스킬은 **순서**를, `z2o rules` 는 **규격**을 맡는다. 둘이 어긋나면 **`z2o rules` 를 따른다.**
+
+## 1. 넣기 — 넣을 원본이 있을 때만
+
+```
+z2o find <제목의 핵심 낱말>      이미 들어와 있나 먼저 본다
+z2o push "<제목>" <파일>          없을 때만
+```
+
+- ⚠️ **슬랙·티로·캘린더는 매시 자동 수집된다.** 회의록을 손으로 또 넣으면 **같은 회의가 두 벌**이 된다.
+  `find` 로 찾아지면 넣지 않는다. 방금 끝난 회의면 한 시간 뒤 다시 본다.
+- 원본은 **한 글자도 고치지 않고** 넣는다. 요약은 넣지 않는다 — 요약은 5단계에서 위키에 쓴다.
+- 비밀번호·토큰·계좌번호가 보이면 **넣기 전에 사람에게 묻는다.**
+
+## 2. 뼈대 — 한 번
+
+```
+z2o build
+```
+
+원문(`docs/`)·장부·표를 **코드가** 만든다(0원). 이게 없으면 요약에 건 링크가 깨진다.
+**두 번 부르지 않는다.**
+
+## 3. 할 일 보기
+
+```
+z2o pending            요약이 필요한 원본
+z2o raw <id> <id> ...  한 번에 여러 개 읽는다
+```
+
+잡담뿐인 원본도 있다. **남길 사실만** 추린다 — 누가·무엇을·언제·숫자.
+
+## 4. 붙일 자리 찾기 — 건너뛰지 않는다
+
+```
+z2o list topics/
+z2o search <낱말>
+z2o read topics/<후보>.md
+```
+
+**새 문서는 맞는 주제가 정말 없을 때만** 만든다. 새 문서만 늘리면 위키가 누적되지 않고 흩어진다.
+원문 문서의 경로는 `z2o list docs/` 로 확인한다 — **2단계가 만든 경로를 그대로** 쓴다.
+
+## 5. 고쳐 쓰기
+
+주제 문서는 두 층이다(자세한 모양은 `z2o rules`).
+
+- **산문** — 새 자료를 반영해 **다시 쓴다.** 이어 붙이지 말고 한 덩어리로.
+- **`## 문서` 줄** — 기존 줄은 **한 글자도 지우거나 고치지 않는다.** 새 원본 줄만 덧붙인다:
+  `- [[docs/<경로>|<제목>]] — 한 줄 설명`
+
+파일은 임시로 쓰고 올린다.
+
+```
+z2o write topics/<주제>.md <임시파일>
+```
+
+- 문서 머리(`type`·`tags`·`updated`)가 없으면 서버가 틀을 보여 주며 거절한다 — 그 틀대로 고친다.
+- **쓰면 안 되는 곳**: `ledger/` `entities/` `tables/` `docs/` `calendar/` `meetings/` `index.md` `log.md` `overview.md` — 코드가 만든다. 서버도 거절한다.
+
+## 6. 확인
+
+```
+z2o pending
+```
+
+요약이 원문 문서를 링크하면 그 원본은 **pending 에서 빠진다.** 안 빠졌으면 **링크 경로가 틀린 것**이다 —
+`z2o list docs/` 와 대조해 고친다.
+
+## 보고
+
+사람에게 짧게: 넣은 원본 · 고친/새로 만든 문서 · 남은 pending 수 · **원본끼리 어긋난 것**(날짜·숫자·사람).

package/plugin/skills/read/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: read
+description: 회사(제로투원) 맥락이 필요할 때 쓴다 — 슬랙·회의록·메일·위키에서 찾아 답한다. "슬랙에서 뭐라고 했지", "지난 회의에서 정한 거", "우리 회사 ~ 어떻게 됐어", "z2o 에서 찾아줘", "최근 얘기 정리해줘" 같은 요청. 사람에게 복사해 달라고 하지 않고 z2o 로 직접 꺼낸다.
+allowed-tools:
+  - Bash(z2o *)
+---
+
+# /z2o:read — 회사 맥락 꺼내기
+
+회사의 슬랙·회의록·메일·정리된 위키는 전부 `z2o` 명령으로 꺼낸다.
+**사람에게 "복사해서 붙여 주세요"라고 하지 않는다.** 이 스킬은 읽기만 한다 — 쓰기는 `/z2o:ingest`.
+
+요청: `$ARGUMENTS`
+
+## 어디서 찾나 — 둘로 나뉜다
+
+| | 무엇 | 명령 |
+|---|---|---|
+| **원본** | 들어온 그대로. 슬랙·메일·티로. **가장 최신** | `z2o recent [개수]` · `z2o find <낱말>` · `z2o raw <id...>` |
+| **위키** | 정리된 지식. 주제·개체·장부 | `z2o list [접두어]` · `z2o search <낱말>` · `z2o read <경로...>` · `z2o graph` |
+
+- **오늘·이번 주·"슬랙에서"** 같은 요청 → 원본부터. `recent` 로 훑고 `raw` 로 읽는다.
+- **"~가 뭐였지", "~ 현황"** 같은 요청 → 위키부터.
+- 둘 다 본 뒤 **어긋나면 둘 다 말한다.** 원본이 더 최신이다 — 위키는 정리된 시점에 멈춰 있다.
+
+## 위키 찾는 법
+
+1. `z2o read index.md overview.md` — 목차와 종합. 어디를 볼지 여기서 정한다.
+2. `z2o list topics/` 처럼 **접두어로 목록**을 본다. 위키가 100장 안팎이면
+   **목록을 보고 관련 문서를 통째로 읽는 편이 검색보다 낫다.**
+3. `z2o search` 는 **낱말을 그대로 포함한 것만** 찾는다(최대 30건, 뜻으로 찾지 않는다).
+   동의어·다른 표기로 **여러 번** 찾는다. 예: `타임원`·`TimeOne`·`외주`
+4. `z2o read a.md b.md c.md` — **여러 장을 한 번에**(한 번에 40장·12만 자까지).
+5. 주제 문서의 `## 문서` 줄은 원문(`docs/`)을 가리킨다. 산문이 모호하면 원문을 읽는다.
+
+## 답할 때
+
+- **출처를 붙인다** — 문서 경로(`topics/물류.md`)나 원본 id(`d213b634`).
+- 못 찾았으면 **못 찾았다고 한다.** 짐작으로 메우지 않는다.
+- 워크스페이스가 여럿이면 `-c <id>` 로 고른다. 모르겠으면 `z2o companies`.
+
+## 막히면
+
+- `토큰이 없어요` → 사람에게 `z2o init` 을 안내한다. **토큰을 대화로 받지 않는다** — 사람이 직접 넣는다.
+- `워크스페이스를 정하세요` → `z2o companies` 로 보여 주고 사람이 `z2o use` 로 고르게 한다.