@bifos/dooray-cli 0.13.0 → 0.14.0

package/skills/dooray-cli/references/comment.md

@@ -0,0 +1,39 @@
+# comment
+
+업무 댓글 추가, 목록 필터, 단일 댓글 본문 조회를 다룬다.
+
+### 댓글 추가 (non-interactive)
+
+```bash
+dooray post comment add <project> <number> --body "댓글 내용"
+dooray post comment add <project> <number> --body-file ./comment.md
+```
+
+
+### 댓글 목록 필터 (non-interactive)
+
+```bash
+# 최신 5개
+dooray post comment list <project> <number> --latest 5
+# 특정 날짜 이후
+dooray post comment list <project> <number> --since 2026-04-27
+# 작성자 필터
+dooray post comment list <project> <number> --from-author 홍길동
+# 최신 댓글 1개 빠른 조회
+dooray post comment latest <project> <number>
+```
+
+
+---
+
+## 단일 댓글 본문 fetch
+
+`post comment get <project> <post-number> <comment-id> --json` 으로 단일 댓글의 본문 + attachments 를 곧장 fetch. `comment list` 후 jq 필터링 우회 불필요.
+
+본문 patch 흐름:
+1. `dooray post comment get <p> <n> <id> --json | jq -r '.body.content' > current.md`
+2. (편집)
+3. `dooray post comment edit <p> <n> <id> --body-file current.md --no-confirm` (attachment guard 통과)
+
+---
+

package/skills/dooray-cli/references/common.md

@@ -0,0 +1,111 @@
+# common
+
+설치, 초기 설정, 출력 모드, Dooray API 제약사항, 피드백 등록, 에러 핸들링, 캐시, projectId 직접 입력을 다룬다.
+
+## 설치
+
+```bash
+npm install -g @bifos/dooray-cli
+```
+
+## 초기 설정
+
+대화형 마법사로 한 번에 설정:
+
+```bash
+dooray setup   # API endpoint 선택, API key 입력, 메일 설정까지 대화형으로 진행
+```
+
+또는 개별 수동 설정:
+
+```bash
+dooray config set base-url https://api.dooray.com
+dooray config set api-key <YOUR_API_TOKEN>   # https://{org}.dooray.com/setting/api/token
+dooray doctor                                 # 설정 검증
+```
+
+## 출력 모드
+
+| 플래그 | 설명 | 용도 |
+|--------|------|------|
+| (없음) | 사람이 읽기 좋은 테이블 | 기본 |
+| `--json` | JSON 출력 (stdout) | 파싱, 체이닝 |
+| `--quiet` | ID만 출력 | 스크립팅 |
+
+**AI 에이전트는 `--json`을 사용하여 구조화된 데이터를 파싱하라.**
+
+---
+
+## 제약사항 (Dooray API 한계)
+
+CLI로 처리 **불가능한** 작업. 아래 항목을 요청받으면 웹 UI 사용을 안내할 것.
+
+| 작업 | 대체 경로 | 근거 |
+|---|---|---|
+| 위키 페이지 이동 (상위 페이지 변경) | 웹 UI (`https://{tenant}.dooray.com/wiki/...`) | Dooray REST API 미지원 |
+| 프로젝트 삭제 | 웹 UI (admin 페이지) | API 미지원 |
+
+위키 페이지를 잘못 만든 경우(테스트/중복)는 `dooray wiki page delete <project> <page-id>` 로 정리한다.
+공식 문서화된 endpoint 가 아니라 서버 정책이 바뀌면 동작이 달라질 수 있음에 유의한다.
+
+---
+
+## 피드백 (GitHub Issue 등록)
+
+`dooray feedback` 명령으로 dooray-cli GitHub issue를 직접 등록한다 (`gh` CLI 위임).
+
+```bash
+# 논인터랙티브 (non-interactive — 에이전트 자동화용)
+dooray feedback --title "버그 제목" --body "재현 방법" --label "bug"
+
+# --last 모드 (직전 에러 자동 첨부 — track-last-run 활성화 필요)
+dooray config set track-last-run true
+dooray feedback --last --title "에러 제목" --body "추가 설명" --dry-run  # 미리보기
+dooray feedback --last --title "에러 제목" --body "추가 설명"            # 실제 등록
+```
+
+> **참고**: `--last` 모드는 `trackLastRun: true` (opt-in)가 설정된 경우에만 직전 실패 명령이 자동 기록됨.
+> argv는 시크릿 패턴(`--api-key`/`--token`/`Authorization`) 마스킹 후 저장.
+
+
+## 에러 핸들링
+
+CLI 에러 발생 시 복구 방법:
+
+| 에러 메시지 | 원인 | 복구 방법 |
+|------------|------|-----------|
+| `프로젝트를 찾을 수 없습니다: xxx` | 프로젝트 코드/ID 오류 | `dooray project list --search "xxx"` 로 정확한 코드 확인 |
+| `복수의 멤버가 매칭됩니다: "김"` | 이름이 모호함 | 에러 메시지의 후보 목록에서 정확한 이름으로 재시도 |
+| `멤버를 찾을 수 없습니다: xxx` | 해당 프로젝트에 멤버 없음 | `dooray project members <project>` 로 멤버 목록 확인 |
+| `워크플로우를 찾을 수 없습니다: xxx` | 워크플로우 이름 오류 | `dooray project workflows <project>` 로 확인 |
+| `API 호출 실패 (401)` | API 키 만료/오류 | `dooray doctor` 로 설정 검증 |
+
+---
+
+## projectId 직접 입력 시나리오
+
+AI agent 가 `member=me` 응답에 없는 프로젝트의 업무를 다뤄야 할 때:
+
+1. **사용자가 projectId (15+자리 numeric) 를 줬으면 그대로 명령에 사용**:
+   ```bash
+   dooray post search 1234567890123456789 "keyword"
+   ```
+
+2. **사용자가 코드만 줬고 cache 매칭 실패 (member 아닌 프로젝트)**:
+   - 에러 메시지의 안내 확인
+   - 사용자에게 "프로젝트 ID 가 필요합니다 — Dooray UI 의 프로젝트 URL 에서 확인 가능" 요청
+   - 또는 `dooray project list --type private` 로 private 캐시 갱신 시도
+
+3. **권한 없는 projectId 입력 시**: resolver 통과 후 후속 API 4xx 발생 — 에러 메시지에서 권한 부재 확인 후 사용자에게 보고
+
+권한 검증이 resolver 단보다 한 단계 지연되는 trade-off — AI 친화적 자동화 우선.
+
+
+## 캐시
+
+프로젝트, 멤버, 워크플로우, 위키 정보는 `~/.dooray/cache/`에 캐시된다.
+캐시가 오래된 것 같으면:
+
+```bash
+dooray cache clear   # 전체 캐시 삭제 (다음 실행 시 자동 갱신)
+```

package/skills/dooray-cli/references/intent-map.md

@@ -0,0 +1,92 @@
+# intent-map
+
+자연어 요청을 dooray-cli 커맨드로 변환할 때 참고하는 마스터 표.
+
+## 의도 → 커맨드 매핑
+
+자연어 요청을 커맨드로 변환할 때 아래 표를 참고한다.
+
+> **공통 (post 하위 16개 명령)**: 아래 명령은 `<project> <number>` 외에도 `--id <postId>`, `--url <url>`, 또는 첫 인자에 Dooray URL 을 직접 받는다.
+> `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`, `post comment file list`/`upload`/`download`/`delete`.
+>
+> 지원 URL 형식 3종 (positional 첫 인자 / `--url` 공통):
+> - `https://*.dooray.com/task/to/<postId>`
+> - `https://*.dooray.com/task/<projectId>/<postId>` — 브라우저 주소창 복사본
+> - `https://*.dooray.com/project/tasks/<postId>` — 프로젝트 업무 목록 → 업무 열기
+>
+> **사용자가 URL을 줬으면 그대로 첫 인자로 전달**하는 것이 가장 빠른 경로 (resolve 단계 단축).
+
+| 의도 | 커맨드 |
+|------|--------|
+| 초기 설정 (대화형) | `dooray setup` |
+| 프로젝트 찾기 | `dooray project list --search <keyword>` |
+| 개인 프로젝트 목록 | `dooray project list --type private` |
+| 프로젝트 멤버 보기 | `dooray project members <project>` 또는 `dooray member list <project>` (이름·organizationMemberId) |
+| 프로젝트 멤버 그룹 목록 | `dooray project groups <project>` (ID / Code) |
+| 프로젝트 태그 목록 | `dooray project tags <project>` (ID / Color / Name / Group / Mandatory) |
+| 프로젝트 템플릿 목록 | `dooray project templates <project>` (id / templateName) |
+| 멤버 상세 (organizationMemberId) | `dooray member get <organizationMemberId>` (cache 우회) |
+| organization 전체 멤버 검색 | `dooray member search <keyword>` (이름 기본), `--email`(이메일 exact), `--user-code`(사번 like), `--user-code-exact`(사번 exact), `--page`/`--size` |
+| 업무 목록 조회 | `dooray post list <project>` |
+| 업무 검색 | `dooray post search <project|projectId> "<keyword>"` — projectId (15+자리 numeric) 직접 입력 시 cache 우회 |
+| 업무 상세 보기 | `dooray post get <project> <number>` (번호) / `dooray post get --id <postId>` (internal ID) |
+| 업무 생성 | `dooray post create <project> --title "..." [--body "..." \| --body-file <path>]` (`--tag`/`--parent`/`--workflow`/`--milestone` 지원) |
+| 템플릿 기반 업무 생성 | `dooray post create <project> --template <name\|id>` — body/users/tags 자동 채움 (사용자 옵션 우선 override) |
+| 업무 제목/본문 수정 | `dooray post edit <project> <number> --title "..." --body "..."` 또는 `--body-file <path>` |
+| 업무 완료 처리 | `dooray post done <project> <number>` |
+| 업무 워크플로우 변경 | `dooray post workflow <project> <number> <workflow>` |
+| 댓글 조회 | `dooray post comment list <project> <number>` (`--sort`, `--reverse`, `--latest`, `--since`, `--from-author` 필터. table: Creator 자동 채움, `--json`: raw) |
+| 최신 댓글 조회 | `dooray post comment latest <project> <number>` — 최신 댓글 1개 빠른 조회. `-n <N>`으로 N개 지정 |
+| 단일 댓글 조회 | `dooray post comment get <project> <number> <comment-id>` — 본문·메타·attachments 직접 fetch. `--id`/`--url` + `--comment-id` 모드 지원 |
+| 댓글 추가 | `dooray post comment add <project> <number> --body "..."` 또는 `--body-file <path>` |
+| 댓글 수정 | `dooray post comment edit <project> <number> <comment-id> --body "..."` 또는 `--body-file <path>` |
+| 댓글 삭제 | `dooray post comment delete <project> <number> <comment-id>` |
+| 위키 목록 | `dooray wiki list` |
+| 위키 페이지 목록 | `dooray wiki pages <project>` |
+| 위키 페이지 트리 | `dooray wiki tree <project>` (계층 트리, `--depth N` 상한, `--json` 은 flat) |
+| 위키 페이지 상세 | `dooray wiki page get <project> <page-id>` |
+| 위키 페이지 생성 | `dooray wiki page create <project> --title "..." [--parent <page-id>] [--body "..."]` (--parent 생략 시 위키 home 페이지 아래 생성) |
+| 위키 페이지 수정 (제목) | `dooray wiki page edit <project> <page-id> --title "..."` |
+| 위키 페이지 수정 (본문) | `dooray wiki page edit <project> <page-id> --body "..."` 또는 `--body-file ./new.md` |
+| 위키 페이지 수정 (에디터) | `dooray wiki page edit <project> <page-id>` (플래그 없으면 $EDITOR 열림) |
+| 위키 페이지 삭제 | `dooray wiki page delete <project> <page-id>` (y/N 확인 기본, `--yes`로 자동화 시 생략. 하위 페이지는 상위 페이지로 재부착) |
+| 위키 페이지 첨부 목록 | `dooray wiki page file list <project> <page-id>` (general + inline 합산, type 컬럼) |
+| 위키 페이지 첨부 업로드 | `dooray wiki page file upload <project> <page-id> --file <path> [--type inline_image]` (multipart `type` 필드를 `file` 앞에 전송) |
+| 위키 페이지 첨부 다운로드 | `dooray wiki page file download <project> <page-id> --file-id <id> -o <dir>` |
+| 위키 페이지 첨부 일괄 다운로드 | `dooray wiki page file download-all <project> <page-id> -o <dir>` (files + images 전부) |
+| 위키 페이지 첨부 삭제 | `dooray wiki page file delete <project> <page-id> --file-id <id>` (confirm 없음) |
+| 위키 페이지 댓글 목록 | `dooray wiki page comment list <project> <page-id> [--latest N]` (최신순) |
+| 위키 페이지 최신 댓글 | `dooray wiki page comment latest <project> <page-id>` |
+| 위키 페이지 댓글 조회 | `dooray wiki page comment get <project> <page-id> <comment-id>` |
+| 위키 페이지 댓글 추가 | `dooray wiki page comment add <project> <page-id> --body "..."` ($EDITOR fallback) |
+| 위키 페이지 댓글 수정 | `dooray wiki page comment edit <project> <page-id> <comment-id> --body "..."` |
+| 위키 페이지 댓글 삭제 | `dooray wiki page comment delete <project> <page-id> <comment-id>` (confirm 없음) |
+| 메일 목록 조회 | `dooray mail list` |
+| 안읽은 메일 | `dooray mail list --unread` |
+| 메일 제목 검색 | `dooray mail list --search "<keyword>"` |
+| 메일 상세 | `dooray mail get <uid>` |
+| 메일 발송 | `dooray mail send --to "..." --subject "..." --body "..."` |
+| 메일 답장 | `dooray mail reply <uid> --body "..."` |
+| 메신저 1:1 다이렉트 메시지 | `dooray messenger send --to "<id\|email>" --body "..."` (`--to`는 id/이메일만, 이름 미지원) |
+| 메신저 대화방 메시지 | `dooray messenger channel-send --channel "<channelId\|이름>" --body "..."` (이름은 자신이 속한 방만 검색) |
+| 첨부파일 목록 | `dooray post file list <project> <number>` |
+| 첨부파일 다운로드 | `dooray post file download <project> <number> <file-id>` |
+| 전체 첨부파일 다운로드 | `dooray post file download-all <project> <number>` |
+| 첨부파일 업로드 | `dooray post file upload <project> <number> <file-path>` |
+| 첨부파일 삭제 | `dooray post file delete <project> <number> <file-id>` |
+| file 명령군 자동화 파싱 | `dooray post file <verb> ... --json` — `download` = `{outputPath,fileName,size}`, `download-all` = `{count,succeeded,failed}` (부분 실패 시 exit 1), `delete` = `{fileId,status}`, `upload` = `res.result` raw |
+| 댓글 첨부 목록 | `dooray post comment file list <project> <number> <comment-id>` |
+| 댓글 파일 업로드 | `dooray post comment file upload <project> <number> <comment-id> <path>` |
+| 댓글 파일 다운로드 | `dooray post comment file download <project> <number> <comment-id> <file-id>` |
+| 댓글 파일 삭제 | `dooray post comment file delete <project> <number> <comment-id> <file-id> --yes` |
+| 참조자(cc) 멤버/그룹 추가 | `dooray post edit <project> <number> --cc-group <code>` — 기존 참조자 유지 + 그룹 추가 (dedupe) |
+| 참조자 전체 교체 | `dooray post edit <project> <number> --cc-clear --cc <name>` — 기존 참조자 비우고 신규 멤버만 |
+| 신규 업무 + 그룹 cc | `dooray post create <project> --title "..." --cc-group <code>` — 생성 시 그룹 참조자 포함 |
+| `--cc-group <code\|id>` / `--mention-group <code\|id>` | 그룹 매칭 — 15+자리 numeric → id 직접 / 그 외 → code matchByName (부분일치) |
+| 상위 업무 설정/변경 | `dooray post edit <project> <number> --title "<원제목>" --parent <ref>` (`<ref>`: `<project>/<number>` 또는 raw postId. `--title` 필수, unset 미지원) |
+| `dooray post edit --id <postId> --tag <name>` | 태그 추가 (반복, dedupe) |
+| `dooray post edit --id <postId> --tag-clear --tag <name>` | 태그 전체 교체 |
+| `dooray post edit --id <postId> --tag-remove <name>` | 특정 태그 제거 |
+
+> **제목 옵션 네이밍**: `post` 와 `wiki page` 모두 `--title` 표준. `post`의 `--subject`는 deprecated alias로 당분간 동작하되, 새 코드에서는 `--title` 사용을 권장.
+

package/skills/dooray-cli/references/mention-link.md

@@ -0,0 +1,104 @@
+# mention-link
+
+그룹 멘션/cc 의사결정, 멘션·링크 자동 삽입, Dooray 마크다운 링크 형식(멤버/그룹/업무/위키 페이지)을 다룬다.
+
+## 그룹 멘션 / cc 시 AI agent 동선
+
+자연어 그룹명을 사용자가 지칭했을 때 AI agent 의 의사결정 순서:
+
+1. **사용자가 명확한 code 를 줬으면 바로 시도**
+   ```bash
+   dooray post create <project> --mention-group "<code>"
+   ```
+   부분일치 가능 (예: "AI-Data" → "AI-Data파트" 매칭).
+
+2. **부분일치 모호 / 매칭 실패 시 후보 탐색**
+   ```bash
+   dooray project groups <project>
+   ```
+   ID + Code 표 출력.
+   AI agent 가 자연어 의도와 가장 가까운 code 선택 후 재시도.
+
+3. **모든 컬럼이 빈값일 때 (response shape 이상) 회피**
+   - 최근 수정 이후 거의 발생 안 함 (`fetchAllMemberGroups` 가 nested array 정규화)
+   - 만약 발생 시: 사용자에게 그룹 id (UI 의 그룹 URL 에서 19자리 numeric) 확인 요청
+   - `--cc-group <id>` / `--mention-group <id>` 직접 입력
+   - 또는 그룹 멤버를 개별 `--cc <member>` / `--mention <member>` 로 지정
+
+4. **모호한 자연어 매핑은 사용자에게 확인**
+   - 후보가 여러 개일 때 임의 선택 금지 — 사용자에게 선택지 제시
+   - 예: "AI-Data파트 / AI-Data실험팀 — 어느 그룹인가요?"
+
+순서 고정 — 멤버 먼저, 그룹 다음 (기존 정책 유지).
+
+
+## 멘션·링크 자동 삽입 (first-class)
+
+`post create`, `post edit`, `post comment add`, `post comment edit` 모두 지원:
+
+- `--mention <name>` (반복) — 이름으로 멤버 resolve 후 dooray:// markdown prepend
+- `--mention-group <code>` (반복) — 그룹 코드로 resolve
+- `--link-task <project>/<number>` (반복) — 다른 업무 link 를 본문 끝에 append. 19자리 postId 도 가능
+- `--dry-run` — API 호출 없이 합성 결과만 stdout. CI / 자동화 검증용
+
+```bash
+dooray post comment add P 1 --mention 홍길동 --mention-group 개발 --body "..."
+# 결과 본문: [@홍길동](dooray://orgId/members/m1 "member") [@P/개발](dooray://orgId/member-groups/g1) ...
+```
+
+- 이름 부분일치 지원 (모호하면 에러 + 후보 목록 출력)
+- 멤버 먼저, 그룹 다음 순서 고정
+- interactive (`$EDITOR`) 모드의 `post edit` 는 mention/link-task 무시 + stderr 경고
+
+
+## Dooray 마크다운 링크 형식 (멤버·그룹·업무·위키 페이지 멘션)
+
+댓글/본문 작성 시 다음 형식으로 마크업하면 Dooray 앱이 인식해 inline 멘션·navigation으로 렌더링한다.
+ID는 본인 환경 값으로 채워 사용 — `dooray member get` / `project groups` / `post get` 등으로 조회.
+
+### 멤버 멘션
+```markdown
+[@본인이름](dooray://{orgId}/members/{memberId} "me")
+[@타인이름](dooray://{orgId}/members/{memberId} "member")
+```
+- title 속성: 본인은 `"me"`, 타인은 `"member"`
+- URL: `dooray://{orgId}/members/{memberId}`
+
+### 그룹 멘션 (member-group)
+```markdown
+[@projectCode/그룹명](dooray://{orgId}/member-groups/{groupId})
+```
+- **`projects/{projectId}/` 경로 포함하지 않음** (직관과 반대 — 흔한 실수)
+- title 속성 **없음**
+- URL: `dooray://{orgId}/member-groups/{groupId}`
+
+### 업무(task) 링크
+```markdown
+[projectCode/{number} {subject}](dooray://{orgId}/tasks/{postId} "registered")
+```
+- 표시 텍스트: `{project}/{number} {subject}`
+- URL: `dooray://{orgId}/tasks/{postId}`
+- title: workflow class — `registered` / `working` / `closed` / `backlog`
+- 클릭 시 외부 브라우저 안 열고 Dooray 앱 내부 navigation + workflow 상태 표시
+
+### 위키 페이지 링크
+```markdown
+[표시텍스트](dooray://{orgId}/pages/{pageId} "publish")
+```
+- URL: `dooray://{orgId}/pages/{pageId}`
+- title: 페이지 상태 (`publish` 등) — 업무 링크의 workflow class 자리에 대응
+- 업무(task) 링크와 대칭 구조
+  - `orgId` 동일
+  - 경로만 `pages/{pageId}` 로 차이
+
+### 필요 ID 조회 명령
+
+| ID | 조회 |
+|---|---|
+| `orgId` | Dooray 앱/웹 URL에서 추출 (`https://{org}.dooray.com/...`의 도메인 + 별도 확인 필요) |
+| `memberId` | `dooray member get <id>`, `dooray member search <name>`, `--email <addr>`, `--user-code <code>` 등으로 검색 |
+| `groupId` | `dooray project groups <project>` |
+| `postId` | `dooray post get <project> <number> --json` 의 `id` 필드 |
+| `pageId` | `dooray wiki page get <project> <page-id> --json` 의 `id` 필드 |
+
+---

package/skills/dooray-cli/references/post.md

@@ -0,0 +1,218 @@
+# post
+
+업무(post) 식별 방식, 생성, 수정, 참조자/담당자 변경, 본문 수정 시 attachment 보호, 동명이인 우회, 부모 업무 지정, 태그 자동화를 다룬다.
+
+## 커맨드 상세
+
+### 업무 식별 방식 (post 하위 16개 명령 공통)
+
+아래 16개 명령은 4가지 입력을 모두 받는다:
+`post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`, `post comment file list`/`upload`/`download`/`delete`.
+
+```bash
+# (1) 기존 positional — 가장 익숙한 형태 (<number> 는 업무 번호 #N)
+dooray post get <project> 42
+
+# (2) Dooray URL을 첫 인자로 — 사용자 메시지에서 URL을 그대로 복사할 때 최적
+#     지원 형식 3종 모두 동일하게 작동
+dooray post get https://x.dooray.com/task/to/<postId>
+dooray post get https://x.dooray.com/task/<projectId>/<postId>
+dooray post get https://x.dooray.com/project/tasks/<postId>
+
+# (3) --id <postId>  — post create 결과의 .id 를 그대로 전달
+dooray post get --id <postId>
+
+# (4) --url <url>  — URL 형식 3종 모두 지원
+dooray post get --url https://x.dooray.com/task/to/<postId>
+```
+
+> ⚠️ **`post create` 결과 `.id` 는 internal postId (19자리 숫자)입니다.**
+> 이 숫자를 `<project> <업무번호>` 의 번호 자리에 넣으면 안내 에러가 발생합니다.
+> 후속 조회·수정·댓글은 반드시 **`--id <postId>`** 를 사용하세요.
+>
+> ```bash
+> POST_ID=$(dooray post create <project> --title "..." --json | jq -r '.id')
+> dooray post get --id "$POST_ID"                          # ✅ --id 사용
+> dooray post comment add --id "$POST_ID" --body "댓글"   # ✅ --id 사용
+> # dooray post get <project> "$POST_ID"                  # ❌ 안내 에러 발생
+> ```
+
+**우선순위 / 충돌 규칙**: `--id`+`--url` 동시 지정 → 에러.
+`--id`/`--url`+positional 동시 지정 → 에러.
+URL/`--id`/`--url` 모드는 standalone API(`getPost(postId)`)로 resolve 단계를 단축.
+
+**sub-id 옵션화** (URL/`--id`/`--url` 모드에서 필수):
+```bash
+# comment edit/delete: --comment-id
+dooray post comment edit  --url <url> --comment-id <commentId> --body "..."
+dooray post comment delete --url <url> --comment-id <commentId>
+
+# file download/delete: --file-id
+dooray post file download --url <url> --file-id <fileId> -o ./downloads
+dooray post file delete   --url <url> --file-id <fileId>
+
+# file upload: --file (로컬 경로)
+dooray post file upload   --url <url> --file ./report.pdf
+```
+
+기존 positional 3-arg(`comment edit <project> <number> <comment-id>`, `file upload <project> <number> <path>`)는 그대로 유지.
+
+### 업무 생성 (non-interactive)
+
+```bash
+dooray post create <project> \
+  --title "제목" \
+  --body "본문 마크다운" \
+  --to "담당자이름" \           # 여러 명: --to "김철수" --to "이영희"
+  --cc "참조자이름" \
+  --priority normal \           # highest, high, normal, low, lowest
+  --due-date "2026-04-30T18:00:00+09:00" \
+  --tag "버그" --tag "긴급" \   # 반복 지정. mandatory 그룹은 클라이언트 사전 검증
+  --parent "<project>/337" \       # "code/number" 또는 raw postId 두 형태만 허용
+  --workflow "진행 중" \         # 이름 또는 class (registered/working/closed). 부분일치 모호 시 후보 + 에러
+  --milestone "Sprint 12"
+```
+
+본문이 길면 파일로 (`--body`와 `--body-file`은 함께 사용 불가):
+```bash
+dooray post create <project> --title "제목" --body-file ./content.md
+```
+
+> **`--workflow` 동작 주의**: 워크플로우 설정은 post 생성 *후속* 호출.
+> resolve/설정에 실패해도 stderr 경고만 출력되고 **exit code는 0** (post는 이미 생성됨).
+> 자동화 스크립트에서 워크플로우 적용 여부를 보장해야 하면 stderr를 별도 점검할 것.
+
+### 업무 수정 (non-interactive)
+
+```bash
+# 제목만 변경
+dooray post edit <project> <number> --title "새 제목"
+
+# 본문만 변경
+dooray post edit <project> <number> --body "새 본문"
+
+# 제목 + 본문 동시 변경
+dooray post edit <project> <number> --title "새 제목" --body-file ./updated.md
+```
+
+### 참조자(cc) / 담당자(to) 변경 — 멤버 · 그룹
+
+```bash
+# 기존 참조자 유지 + 그룹 추가 (dedupe: organizationMemberId / projectMemberGroupId)
+dooray post edit <project> <number> --cc-group dev-team
+
+# 기존 참조자 전부 비우고 신규 멤버만
+dooray post edit <project> <number> --cc-clear --cc 홍길동
+
+# 담당자(to)도 동일 패턴: --to / --to-group / --to-clear
+dooray post edit <project> <number> --to 김철수 --to-group qa-team
+```
+
+dry-run 으로 변경 결과 미리보기 (API 호출 없음):
+
+```bash
+dooray post edit --id "$POST_ID" --cc-group qa-team --dry-run --json \
+  | jq '.users.cc'
+```
+
+> interactive (`$EDITOR`) 모드에서는 위 옵션이 무시되고 stderr 경고가 출력됩니다.
+
+
+---
+
+## 본문 수정 (attachment 보호)
+
+`post edit` / `post comment edit` 는 full-replace 방식이다. 자동화에서는 다음 중 하나를 선택:
+
+1. **기존 attachment 보존**:
+   - `post edit` 수정 전: `dooray post get <project> <post-number> --json` 으로 `.body.content` 에서 `/files/<id>` 패턴 추출
+   - `post comment edit` 수정 전: `dooray post comment list <project> <post-number> --json` 으로 해당 댓글 본문에서 `/files/<id>` 패턴 추출
+   추출한 markdown reference 를 새 본문에 그대로 포함하여 전달
+2. **명시적 제거**: attachment 가 더 이상 필요 없다고 판단하면 `--no-confirm` 으로 진행. 누락이 의도한 결과임을 명시
+
+---
+
+## 동명이인 우회 — 이메일 / memberId 직접
+
+이름이 동일한 멤버가 여러 명이라 `--cc 홍길동` 이 모호로 실패할 때:
+
+```bash
+# 1) 이메일로 우회
+dooray post edit --id "$POST_ID" --cc user.specific@example.com
+
+# 2) 사전에 member search 로 ID 확보 후 직접
+MEMBER_ID=$(dooray member search 홍길동 --json | jq -r '.[] | select(.externalEmailAddress=="user.specific@example.com") | .id')
+dooray post edit --id "$POST_ID" --cc "$MEMBER_ID"
+```
+
+`--to` / `--mention` 동일 분기 (resolveMember 인프라). 분기 규칙:
+- `^\d{15,}$` — memberId 직접 사용
+- 이메일 정규형 — searchMembers exact
+- 그 외 — 이름 부분일치
+
+
+---
+
+## 신규 업무 생성 후 그룹 cc 첨부
+
+자동화 패턴:
+1. audit 리포트 분석
+2. 신규 업무 생성
+3. 후속으로 특정 그룹을 참조에 추가
+
+```bash
+# 1. 신규 업무 생성 (그룹 cc 포함)
+POST_ID=$(dooray post create <project> \
+  --title "주간 audit 리포트" \
+  --body-file ./report.md \
+  --cc-group dev-team \
+  --json | jq -r '.id')
+
+# 2. (필요 시) 후속으로 cc 추가
+dooray post edit --id "$POST_ID" --cc-group qa-team
+```
+
+---
+
+## 자식 업무 먼저 → 후속 부모 지정
+
+```bash
+# 1. 자식 업무 생성 (parent 모르고)
+CHILD_ID=$(dooray post create <project> --title "subtask A" --json | jq -r '.id')
+
+# 2. 부모 결정 후 후속 지정
+dooray post edit --id "$CHILD_ID" --title "subtask A" --parent <project>/<parent-number>
+```
+
+**한계** (cmux-browser spike 결과): Dooray API 가 `unset-parent-post` 미제공 → CLI 로 parent 해제 불가. 필요 시 웹 UI 에서 처리.
+
+---
+
+## 태그 사후 분류 자동화
+
+분류 분석 결과를 받아 태그를 재분류하는 자동화는 단독 호출 패턴이 효율적:
+
+```bash
+# 분석 스크립트가 분류한 태그 이름을 cli 로 적용 — body fetch 불요
+POST_ID=$(...)
+CATEGORY=$(...)
+dooray post edit --id "$POST_ID" --tag "분류: $CATEGORY"
+```
+
+태그만 변경하는 시나리오에서 `--title` / `--body` 강제 없음.
+mandatory 그룹은 친절한 에러 메시지로 안내.
+
+---
+
+## 첨부파일 일괄 다운로드 후 실패 분리
+
+```bash
+# --json 으로 구조화 출력 → jq 로 성공/실패 분리
+RESULT=$(dooray post file download-all <project> <number> -o ./ --json)
+echo "$RESULT" | jq -r '.failed[] | "\(.fileId): \(.error)"' >&2
+echo "$RESULT" | jq -r '.succeeded[].path'
+# exit code 1 이 설정되어 있으면 실패 있는 상태
+```
+
+---
+

package/skills/dooray-cli/references/wiki.md

@@ -0,0 +1,77 @@
+# wiki
+
+위키 페이지 조회(트리 포함), 첨부파일 다운로드/공유, 인라인 이미지 업로드, 댓글 누적 시나리오를 다룬다.
+
+## 체이닝 예시 — 위키
+
+### 위키 페이지 조회
+
+```bash
+# 1. 위키 페이지 목록
+dooray wiki pages <project> --json
+# → [{ "id": "<pageId>", "subject": "설계 문서", ... }]
+
+# 2. 페이지 내용 조회
+dooray wiki page get <project> <pageId> --json
+
+# 3. 전체 계층을 트리로 훑기 (--json 은 flat 배열 — wiki pages 와 동일 스키마로 파싱)
+dooray wiki tree <project> --json
+```
+
+
+### 위키 페이지 첨부파일 — 스킬 파일 팀 공유
+
+**스킬 파일 팀 공유**: 팀 위키에 스킬 파일 (예: `SKILL.md`) 을 `wiki page file upload` 로 첨부 → 팀원이 `wiki page file download-all` 로 일괄 받아 `~/.claude/skills/` 에 그대로 설치.
+
+```bash
+# 업로드 (일반 첨부)
+dooray wiki page file upload <project> <page-id> --file ~/.claude/skills/my-skill/SKILL.md
+
+# 팀원 쪽에서 일괄 다운로드
+dooray wiki page file download-all <project> <page-id> -o ~/.claude/skills/my-skill/
+
+# 첨부 목록 확인 (type 컬럼: general / inline_image)
+dooray wiki page file list <project> <page-id>
+```
+
+
+### 위키 페이지 인라인 이미지 업로드 후 본문 자동 삽입
+
+`--type inline_image` 로 업로드 시 `--json` 응답에 `markdownSnippet` 필드가 포함됩니다.
+jq 로 추출해 본문에 바로 삽입하는 자동화가 가능합니다.
+
+```bash
+# 1. 인라인 이미지 업로드 — --json 으로 markdownSnippet 추출
+SNIPPET=$(dooray wiki page file upload <project> <page-id> \
+  --file ./diagram.png --type inline_image --json \
+  | jq -r '.markdownSnippet')
+# SNIPPET = "![diagram.png](/wikis/<wikiId>/files/<attachFileId>)"
+
+# 2. 기존 본문 조회
+CURRENT_BODY=$(dooray wiki page get <project> <page-id> --json | jq -r '.body.content')
+
+# 3. snippet 을 본문 끝에 추가해 업데이트
+NEW_BODY="${CURRENT_BODY}
+
+${SNIPPET}"
+dooray wiki page edit <project> <page-id> --body "$NEW_BODY"
+```
+
+**참고**: `general` 타입은 `markdownSnippet` 없음. `--quiet` 은 id 만 출력 (snippet 미포함).
+
+
+### 위키 페이지 댓글 — 회의록 결정사항 자동 누적
+
+**회의록 결정사항 자동 누적**: 회의록 위키 페이지에 자동화 봇이 `wiki page comment add` 로 결정사항을 댓글로 누적, `wiki page comment list --latest 20` 으로 최근 토론 흐름 추적.
+
+```bash
+# 결정사항 댓글 추가
+dooray wiki page comment add <project> <page-id> --body "결정: 배포일 2026-06-01 확정"
+
+# 최근 20개 토론 흐름 조회
+dooray wiki page comment list <project> <page-id> --latest 20
+
+# 최신 댓글 1건 shortcut
+dooray wiki page comment latest <project> <page-id>
+```
+