프로젝트 커맨드 만들기

프로젝트를 대화에 연결하면 그 프로젝트의 커맨드가 그 대화의 📁 메뉴(대시보드)·/ 목록·텔레그램 /project 에 뜬다. 파일 자리는 <프로젝트>/.tiguclaw/commands/<이름>.md, 만드는 도구는 register_command(project 를 준다). 커맨드가 많으면 하위 폴더로 묶을 수 있다(commands/배포/staging.md → 메뉴에 배포 › /staging). 부르는 이름은 파일 이름 그대로라 폴더가 달라도 이름은 겹치면 안 된다. 묶음은 register_command 의 group(예 배포/스테이징)으로 — 만들 때 주면 그 묶음에, 이미 있는 명령에 group 만 주면 내용은 그대로 두고 옮긴다('' 은 맨 위로). 정리 전에 list_commands(project) 로 지금 묶음을 본다.

1. 종류를 고른다

실행형은 비서 턴 없이 그 프로젝트 폴더에서 돌고, 끝나면 결과(종료 코드·출력 꼬리)가 대화에 온다. 돌고 있는 것은 /stop 이나 대시보드 셸 카드에서 멈춘다.

2. 실행형 요령

• run 은 한 줄이다. 여러 단계면 묶어서 그 한 줄이 부르게 한다:
  • 프로젝트에 package.json 이 있으면 npm 스크립트가 첫 선택이다 — 윈도우·맥·리눅스에서 똑같이 돈다(run: npm run deploy).
  • 없으면 프로젝트 안 스크립트 파일(scripts/deploy.sh 등)을 만들고 run 이 그걸 부른다. 윈도우 사용자라면 셸 차이를 생각한다.
• 되돌리기 어려운 일(배포·삭제·외부로 보내기)은 confirm: true — 돌리기 전에 사용자에게 한 번 묻는다.
• 오래 걸려도 된다(백그라운드 셸). 다만 입력을 기다리는 명령(대화형 프롬프트)은 영원히 멈춰 있으니 피한다(--yes 류 플래그).
• $ARGUMENTS 를 쓰면 /deploy staging 의 staging 이 들어간다.

3. 순서 (★저장 전에 확인)

1. 프로젝트 폴더를 보고(package.json 스크립트·기존 스크립트) 무엇을 돌릴지 정한다.
2. 사용자에게 보여 준다 — 이름 · 종류 · 돌릴 줄(또는 부탁 글) · confirm 여부 · 새로 만들 스크립트 파일이 있으면 그 내용. 셸 명령을 저장하는 일이라 확인 없이 만들지 않는다.
3. 승인받으면 register_command({ name, project, run, confirm, description }).
4. 연결이 안 돼 있으면 «이 대화에 연결할까요?» — 연결해야 메뉴에 뜬다(link_project).
5. 위험하지 않은 것이면 한 번 돌려 보자고 권한다(/project run <프로젝트> <이름>). 배포처럼 위험한 건 사용자가 직접 누르게 둔다.

4. 고치기·지우기

• 고치기: 같은 이름으로 register_command({ ..., overwrite: true }).
• 지우기: delete_command({ name, project }).
• 같은 이름의 전역 커맨드가 있으면 /이름 은 전역이 돈다 — 프로젝트 것은 📁 메뉴나 /project run <프로젝트> <이름> 으로 부른다. 헷갈리면 다른 이름을 권한다.

5. 모든 프로젝트 공통 커맨드

한 번 만들어 연결한 모든 프로젝트의 📁 메뉴에 띄우려면 register_command({ name, scope: "projects", run 또는 prompt }) — 파일은 홈 commands/ 에 scope: projects 로 남는다(project 는 같이 주지 않는다). 누르면 그 프로젝트를 대상으로 돈다: 실행형은 그 프로젝트 폴더에서, 프롬프트형은 앞에 [프로젝트 이름 — 경로] 줄이 붙어 비서에게 간다.

• 언제 공통, 언제 프로젝트 자기 것: 어느 프로젝트에서나 같은 뜻이면(«git 상태 정리», «변경 요약») 공통. 그 프로젝트에만 있는 스크립트를 부르면 프로젝트 자기 것.
• 공통 실행형은 여러 프로젝트에서 돈다 — npm 스크립트가 없는 프로젝트에서도 돌아야 하니 OS 무관한 명령을 고른다(윈도우도 생각한다).
• 같은 이름의 프로젝트 자기 커맨드가 있으면 그쪽이 이긴다(그 프로젝트 메뉴에서 공통이 가려진다). 전역 슬래시 목록·텔레그램 봇 메뉴엔 안 뜬다.
• 연결이 없는 대화에서 /이름 을 치면 «프로젝트를 연결하라» 고 답한다.
• 범위를 바꾸려면 scope: "global"(전역으로) / "projects"(공통으로) 로 덮어쓴다. 덮어쓸 때 scope 를 안 주면 범위는 그대로다.
• 플러그인도 공통 커맨드를 낼 수 있다(메뉴에 🧩<플러그인> 꼬리). 플러그인 실행형은 커맨드별 처음 한 번 승인을 받고(모든 연결 프로젝트·모든 인자에 걸린다, run 줄이 바뀌면 다시 묻는다 · 그 줄이 부르는 스크립트의 내용 변경은 다시 묻지 않는다), 파일에 confirm: true 면 승인과 무관하게 매번 확인한다. 승인을 거두려면 홈 settings.json 의 modules.<플러그인>.approvedCommands.<커맨드> 키를 지운다.