@bifos/dooray-cli 0.15.0 → 0.16.0

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

@@ -1,218 +1,145 @@
 # post
 
-업무(post) 식별 방식, 생성, 수정, 참조자/담당자 변경, 본문 수정 시 attachment 보호, 동명이인 우회, 부모 업무 지정, 태그 자동화를 다룬다.
+대상 지정 방법(`--id` / `--url` / positional URL)은 [SKILL.md](../SKILL.md) 에 있다. 여기에는 post 고유 동작만 둔다.
 
-## 커맨드 상세
+## postId 를 업무 번호 자리에 넣지 않는다
 
-### 업무 식별 방식 (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`.
+`post create --json` 의 `.id` 는 19자리 internal postId 다. 업무 번호(`#42`)가 아니다.
+번호 자리에 넣으면 안내 에러가 난다. 후속 명령에는 `--id` 를 쓴다.
 
 ```bash
-# (1) 기존 positional — 가장 익숙한 형태 (<number> 는 업무 번호 #N)
-dooray post get <project> 42
+POST_ID=$(dooray post create <project> --title "..." --json | jq -r '.id')
+dooray post get --id "$POST_ID"                        # 올바름
+dooray post comment add --id "$POST_ID" --body "댓글"   # 올바름
+dooray post get <project> "$POST_ID"                   # 에러
+```
 
-# (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>
+`--id` 와 `--url` 을 함께 주면 에러다. positional 인자와 `--id`/`--url` 을 섞어도 에러다.
 
-# (3) --id <postId>  — post create 결과의 .id 를 그대로 전달
-dooray post get --id <postId>
+## URL 이나 `--id` 모드에서는 sub-id 를 옵션으로 준다
 
-# (4) --url <url>  — URL 형식 3종 모두 지원
-dooray post get --url https://x.dooray.com/task/to/<postId>
-```
+positional 모드에서 세 번째 인자였던 값이 옵션으로 바뀐다.
 
-> ⚠️ **`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>`)는 그대로 유지.
+기존 positional 형태(`comment edit <project> <number> <comment-id>`)는 그대로 쓸 수 있다.
+
+## 삭제 안전 확인
 
-### 업무 생성 (non-interactive)
+다음 업무 삭제 명령은 같은 안전 확인 정책을 따른다.
+
+- `dooray post comment delete`
+- `dooray post file delete`
+- `dooray post comment file delete`
+
+TTY 확인, non-TTY 실행, `-y`와 `--yes` 사용법은 [SKILL.md](../SKILL.md#삭제-명령의-확인-동작)를 따른다.
+
+## 업무 생성
 
 ```bash
 dooray post create <project> \
   --title "제목" \
   --body "본문 마크다운" \
-  --to "담당자이름" \           # 여러 명: --to "김철수" --to "이영희"
-  --cc "참조자이름" \
-  --priority normal \           # highest, high, normal, low, lowest
+  --to "김철수" --to "이영희" \
+  --cc "참조자" \
+  --cc-group dev-team \
+  --priority normal \
   --due-date "2026-04-30T18:00:00+09:00" \
-  --tag "버그" --tag "긴급" \   # 반복 지정. mandatory 그룹은 클라이언트 사전 검증
-  --parent "<project>/337" \       # "code/number" 또는 raw postId 두 형태만 허용
-  --workflow "진행 중" \         # 이름 또는 class (registered/working/closed). 부분일치 모호 시 후보 + 에러
+  --tag "버그" --tag "긴급" \
+  --parent "<project>/337" \
+  --workflow "진행 중" \
   --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 "새 제목"
+| 옵션 | 받는 값 |
+| --- | --- |
+| `--priority` | `highest` / `high` / `normal` / `low` / `lowest` |
+| `--due-date` | ISO 8601 |
+| `--parent` | `<project>/<number>` 또는 raw postId |
+| `--workflow` | 이름 또는 class (`registered` / `working` / `closed`). 부분일치가 모호하면 후보와 함께 에러 |
+| `--tag` | 반복 지정. mandatory 태그 그룹은 클라이언트가 미리 검증한다 |
 
-# 본문만 변경
-dooray post edit <project> <number> --body "새 본문"
+`--body` 와 `--body-file` 은 함께 쓸 수 없다.
 
-# 제목 + 본문 동시 변경
-dooray post edit <project> <number> --title "새 제목" --body-file ./updated.md
-```
+**`--workflow` 는 생성 후 별도 호출이다.** 설정에 실패해도 업무는 이미 만들어졌으므로
+stderr 에 경고만 나가고 **종료 코드는 0** 이다. 워크플로우 적용을 보장해야 하면 stderr 를 따로 확인한다.
 
-### 참조자(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> --cc-group dev-team        # 기존 유지 + 추가 (중복 제거)
+dooray post edit <project> <number> --cc-clear --cc 홍길동      # 기존 비우고 신규만
 dooray post edit <project> <number> --to 김철수 --to-group qa-team
 ```
 
-dry-run 으로 변경 결과 미리보기 (API 호출 없음):
+`--dry-run --json` 으로 API 호출 없이 결과를 먼저 볼 수 있다.
 
 ```bash
-dooray post edit --id "$POST_ID" --cc-group qa-team --dry-run --json \
-  | jq '.users.cc'
+dooray post edit --id "$POST_ID" --cc-group qa-team --dry-run --json | jq '.users.cc'
 ```
 
-> interactive (`$EDITOR`) 모드에서는 위 옵션이 무시되고 stderr 경고가 출력됩니다.
+참조자·담당자 옵션만 지정하면 `$EDITOR`를 열지 않고 기존 제목·본문·태그를 보존한 채 참여자만 바꾼다.
 
+## 본문 수정은 전체 교체다 — 첨부가 사라질 수 있다
 
----
+`post edit` 와 `post comment edit` 는 본문을 통째로 바꾼다.
+새 본문에 기존 첨부의 이미지 마크다운(`![](/files/<id>)`)이나 일반 링크(`[](/files/<id>)`)가 없으면 확인을 요청하고,
+TTY 가 아니면 중단된다.
 
-## 본문 수정 (attachment 보호)
+첨부를 지키려면 기존 본문에서 reference 를 먼저 뽑아 새 본문에 포함한다.
 
-`post edit` / `post comment edit` 는 full-replace 방식이다. 자동화에서는 다음 중 하나를 선택:
+```bash
+# post edit 전
+dooray post get <project> <number> --json | jq -r '.body.content' | grep -oE '!?\[[^]]*\]\(/files/[^)]+\)'
 
-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` 으로 진행. 누락이 의도한 결과임을 명시
+# post comment edit 전
+dooray post comment get <project> <number> <comment-id> --json | jq -r '.body.content'
+```
 
----
+첨부를 정말 떼려는 것이면 `--no-confirm` 으로 진행한다.
 
-## 동명이인 우회 — 이메일 / memberId 직접
+`comment file list`는 댓글 조회 API가 노출한 첨부만 보여주므로 웹 UI에서 직접 첨부한 파일을 놓칠 수 있다.
+목록이 비어 있으면 `post file list`로 업무 전체 첨부를 확인한다.
 
-이름이 동일한 멤버가 여러 명이라 `--cc 홍길동` 이 모호로 실패할 때:
+## 이름이 겹칠 때
+
+`--cc 홍길동` 이 모호하다는 에러가 나면 이메일이나 memberId 로 지정한다.
 
 ```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
-```
+`--cc`, `--to`, `--mention` 이 같은 규칙으로 값을 해석한다.
 
----
+- 15자리 이상 숫자 → memberId 로 그대로 사용
+- 이메일 형태 → exact 매칭
+- 그 외 → 이름 부분일치
 
-## 자식 업무 먼저 → 후속 부모 지정
+## 부모 업무 지정
 
 ```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 그룹은 친절한 에러 메시지로 안내.
+`--parent` 를 쓸 때 `--title` 이 필수다. 제목을 바꾸지 않으려면 원래 제목을 그대로 넣는다.
+parent 해제는 API 가 지원하지 않아 CLI 로 할 수 없다 — 웹 UI 에서 처리한다.
 
----
+## 태그만 바꾸기
 
-## 첨부파일 일괄 다운로드 후 실패 분리
+`--title` 이나 `--body` 없이 태그 옵션만으로 호출할 수 있다. 기존 본문은 자동으로 다시 전송된다.
 
 ```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 이 설정되어 있으면 실패 있는 상태
+dooray post edit --id "$POST_ID" --tag "분류: 성능"
+dooray post edit --id "$POST_ID" --tag-clear --tag "재분류"
+dooray post edit --id "$POST_ID" --tag-remove "긴급"
 ```
-
----
-

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

@@ -1,95 +1,63 @@
 # wiki
 
-위키 페이지 조회(트리 포함), 첨부파일 다운로드/공유, 인라인 이미지 업로드, 댓글 누적 시나리오를 다룬다.
+## 페이지 계층 훑기
 
-## 체이닝 예시 — 위키
-
-### 위키 페이지 조회
+`wiki tree --json` 은 flat 배열이고 `wiki pages --json` 과 같은 스키마다.
+`parentPageId` 로 계층을 조립하므로 두 명령의 파싱 코드를 공유할 수 있다.
+`wiki pages` 는 root 만 주고, 전체 계층이 필요하면 `wiki tree` 를 쓴다.
 
 ```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
+dooray wiki tree <project> --depth 2        # 깊이 상한
 ```
 
+## 인라인 이미지는 본문에 자동 삽입되지 않는다
 
-### 위키 페이지 첨부파일 — 스킬 파일 팀 공유
-
-**스킬 파일 팀 공유**: 팀 위키에 스킬 파일 (예: `SKILL.md`) 을 `wiki page file upload` 로 첨부 → 팀원이 `wiki page file download-all` 로 일괄 받아 `~/.claude/skills/` 에 그대로 설치.
+`--type inline_image` 로 올려도 본문은 바뀌지 않는다.
+`--json` 의 `markdownSnippet` 을 받아 본문에 직접 넣어야 화면에 보인다.
 
 ```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>)"
+  --file ./diagram.png --type inline_image --json | jq -r '.markdownSnippet')
+# → "![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}
+dooray wiki page edit <project> <page-id> --body "${CURRENT_BODY}
 
 ${SNIPPET}"
-dooray wiki page edit <project> <page-id> --body "$NEW_BODY"
 ```
 
-**참고**: `general` 타입은 `markdownSnippet` 없음. `--quiet` 은 id 만 출력 (snippet 미포함).
+기존 본문을 먼저 받아 뒤에 이어 붙인다 — `--body` 는 전체 교체이므로 snippet 만 넣으면 본문이 사라진다.
 
+## 첨부 일괄 내려받기
 
-### 위키 페이지 댓글 — 회의록 결정사항 자동 누적
+```bash
+dooray wiki page file download-all <project> <page-id> -o <dir>
+dooray wiki page file list <project> <page-id>   # type 컬럼으로 general 과 inline_image 구분
+```
 
-**회의록 결정사항 자동 누적**: 회의록 위키 페이지에 자동화 봇이 `wiki page comment add` 로 결정사항을 댓글로 누적, `wiki page comment list --latest 20` 으로 최근 토론 흐름 추적.
+`list` 는 general 첨부와 inline 이미지를 합쳐 보여준다.
 
-```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>
-```
+- `dooray wiki page delete`
+- `dooray wiki page file delete`
+- `dooray wiki page comment delete`
 
-### 위키 페이지 삭제 — 잘못 만든/중복 페이지 정리
+TTY 확인, non-TTY 실행, `-y`와 `--yes` 사용법은 [SKILL.md](../SKILL.md#삭제-명령의-확인-동작)를 따른다.
 
-**비공식 endpoint 주의**: `wiki page delete` 는 Dooray 가 공식 문서화하지 않은 endpoint 를 쓴다. 동작은 확인됐으나 향후 API 변경에 깨질 수 있으니, 자동화에서 대량 삭제 전 한 건으로 먼저 검증한다. `soft delete`(빈 제목·본문) 우회는 하지 않는다 — 페이지가 트리에 남아 혼란을 준다.
+## 페이지 삭제
 
-```bash
-# project + page-id (positional 2개)
-dooray wiki page delete <project> <page-id>
+`wiki page delete` 는 Dooray 가 공식 문서화하지 않은 endpoint 를 쓴다.
+동작은 확인했지만 서버 정책이 바뀌면 깨질 수 있으니, 대량 삭제 전에 한 건으로 먼저 확인한다.
 
-# Dooray Wiki URL 을 첫 인자로
-dooray wiki page delete https://<tenant>.dooray.com/wiki/...
+빈 제목·본문으로 덮는 soft delete 우회는 쓰지 않는다 — 페이지가 트리에 남아 혼란을 준다.
 
-# --id 모드 (--project 로 wikiId 해석)
-dooray wiki page delete --id <pageId> --project <project>
+하위 페이지가 있는 페이지를 지우면 하위는 삭제한 페이지의 부모 아래로 재부착된다. orphan 은 생기지 않는다.
 
-# 자동화 — 확인 프롬프트 없이 삭제
-dooray wiki page delete <project> <page-id> -y
-```
+## 위키 페이지 이동은 불가능하다
 
+`parentPageId` 를 바꾸는 이동은 API 로 할 수 없다. 수정 요청이 `parentPageId` 를 무시하고 전용 endpoint 도 없다.
+사용자가 이동을 요청하면 웹 UI 를 안내한다.

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

@@ -1,99 +1,61 @@
 # workflow
 
-워크플로우 판단 기준, 정형 task 자동화, 위키 이외 체이닝 시나리오(업무 완료 처리 / 업무 생성 / 댓글 추가 / 스크린샷 첨부 / 메신저 알림)를 다룬다.
+## 모르는 값을 먼저 찾는 순서
 
-## 워크플로우 판단 기준
+| 모르는 것 | 먼저 실행 |
+| --- | --- |
+| 개인 프로젝트 ("내 프로젝트" 언급) | `dooray project list --type private --json` |
+| 프로젝트 코드 | `dooray project list --search <keyword>` |
+| 업무 번호 | `dooray post search <project> "<keyword>"` |
+| 워크플로우 이름 | `dooray project workflows <project>` |
+| 프로젝트 안의 멤버 이름 | `dooray member list <project>` 또는 `dooray project members <project>` |
+| organization 전체 멤버 | `dooray member search <keyword>` — 옵션은 [common.md](common.md) |
 
-1. **"내 프로젝트", "개인 프로젝트" 언급 시** → `dooray project list --type private --json` 으로 개인 프로젝트 먼저 조회
-2. **프로젝트 코드를 모르면** → `dooray project list --search <keyword>` 로 먼저 찾기
-3. **업무 번호를 모르면** → `dooray post search <project> "<keyword>"` 로 검색
-4. **워크플로우 이름을 모르면** → `dooray project workflows <project>` 로 확인
-5. **멤버 이름을 모르면** → `dooray member list <project>` (또는 `dooray project members <project>`) 로 확인
-6. **org 전체 멤버를 찾으려면** → `dooray member search <keyword>` (이름), `--email <addr>`, `--user-code <code>` 중 하나 사용
-7. **결과를 다음 액션에 사용하려면** → `--json` 플래그로 구조화된 데이터 획득
+## 체이닝
 
----
-
-
-## 체이닝 예시
-
-### 업무 찾아서 완료 처리
-
-```bash
-# 1. 업무 검색으로 번호 확인
-dooray post search <project> "graceful shutdown" --json
-# → [{ "number": 42, "subject": "graceful shutdown 구현", ... }]
-
-# 2. 완료 처리
-dooray post done <project> 42
-```
-
-
-### 프로젝트 찾아서 업무 생성
+### 프로젝트를 찾아 업무 생성
 
 ```bash
-# 1. 프로젝트 코드 확인
 dooray project list --search "AI서비스" --json
-# → [{ "code": "ai-service-dev", ... }]
+# → [{ "code": "<project>", ... }]
 
-# 2. 업무 생성
-dooray post create ai-service-dev \
+dooray post create <project> \
   --title "주간보고 2026-W14" \
   --body "## 이번 주 성과\n- 항목1\n- 항목2" \
   --to "김철수"
 ```
 
+### 댓글에 스크린샷 첨부
 
-### 업무 상세 조회 후 댓글 추가
-
-```bash
-# 1. 업무 조회
-dooray post get <project> 42 --json
-
-# 2. 댓글 추가
-dooray post comment add <project> 42 --body "진행 상황 업데이트: 80% 완료"
-```
-
-
-### 시나리오 — 댓글에 스크린샷 자동 첨부
-
-스크립트가 스크린샷을 댓글에 삽입하거나, 에이전트가 결과 파일을 첨부 댓글로 보고할 때 사용.
-Dooray REST API 가 댓글 전용 attachment endpoint 를 미지원하므로 내부적으로 post-level files API + 댓글 본문 PUT 합성으로 동작한다.
+댓글 첨부는 두 단계로 나뉜다 — 댓글을 먼저 만들고 그 ID 로 파일을 올린다.
 
 ```bash
-# 1. 댓글을 먼저 만든다 (텍스트만, --json 으로 commentId 획득)
 COMMENT_ID=$(dooray post comment add <project> <post-num> --body "스크린샷 보고:" --json | jq -r '.id')
-
-# 2. 그 댓글에 파일을 첨부 (post-level 업로드 + 댓글 본문 markdown 자동 추가)
 dooray post comment file upload <project> <post-num> "$COMMENT_ID" ./screenshot.png
 ```
 
+업로드하면 이미지 확장자는 이미지 마크다운으로, 그 외 파일은 일반 링크로 댓글 본문에 붙는다.
 
-### 시나리오 — 배포 알림 메신저 자동 전송
+### 배포 알림 메신저 전송
 
-CI/배포 스크립트가 완료 알림을 담당자 DM 또는 팀 대화방에 자동으로 보낼 때 사용.
-전송은 API 토큰 소유자 명의로 나가며, 본문은 plain text 만 지원한다.
+전송은 API 토큰 소유자 명의로 나가고 본문은 plain text 만 된다.
 
 ```bash
-# 담당자 DM (id 또는 이메일만 가능 — 이름 검색 미지원)
+# DM — --to 는 ID 나 이메일만 받는다 (이름 불가)
 dooray messenger send --to "user@example.com" --body "배포가 완료되었습니다 (v1.2.3)."
 
-# 팀 대화방 (channelId 또는 자신이 속한 대화방 이름)
+# 대화방 — channelId 또는 자신이 속한 방 이름
 dooray messenger channel-send --channel "배포 알림방" --body-file ./release-note.md
 
-# --json 으로 log-id 확인 (자동화 파이프라인에서 후속 처리 시)
+# 후속 처리에 쓸 log id 가 필요하면
 dooray messenger send --to <memberId> --body "..." --json
 ```
 
-
----
-
 ## 정형 task 자동화
 
-매주 같은 형식의 task 를 만드는 자동화는 템플릿 + override 패턴이 효율적:
+매주 같은 형식의 업무를 만들 때는 템플릿에 제목만 덮어쓴다.
 
 ```bash
-# 매주 월요일 실행되는 cron — "주간 릴리스 체크" 템플릿으로 자동 생성
 TODAY=$(date +%Y-%m-%d)
 POST_ID=$(dooray post create <project> \
   --template "주간 릴리스 체크" \
@@ -101,6 +63,5 @@ POST_ID=$(dooray post create <project> \
   --json | jq -r '.id')
 ```
 
-템플릿 본문의 `${year}` / `${month}` 등 매크로는 Dooray 가 자동 치환 (`interpolation=true` 기본).
-사용자 정의 변수는 미지원 — 필요 시 client 측 string replace 로 처리.
-
+템플릿 본문의 `${year}`, `${month}` 같은 매크로는 Dooray 가 치환한다.
+사용자 정의 변수는 지원하지 않으므로 필요하면 받은 본문을 직접 치환한다.