telepty-deliberate

Files (2)

• SKILL.md
• telepty_deliberation_helper.py · scripts/

SKILL.md (first lines)

# Telepty Deliberate

telepty 활성 세션들을 상대로 쌍방향 멀티세션 토론을 시작할 때 사용하는 스킬입니다.
목표는 사용자가 긴 kickoff 프롬프트를 수동 작성하지 않게 하는 것입니다.

이 스킬이 주입하는 protocol template은 아래 7가지를 한 번에 포함합니다:

1. 쌍방향 통신 규칙 (`from` / `reply-to`)
2. 세션 디렉토리 / 프로젝트 매핑
3. sub-deliberation 허용
4. 토론 중 자동 skill matching guide
5. boundary enforcement
6. active reporting
7. 합의 후 즉시 실행 전환 규칙

## 이 스킬이 담당하는 것

- 현재 세션 ID 자동 감지: `echo $TELEPTY_SESSION_ID`
- 활성 세션 목록 수집 + 프로젝트 매핑 자동 생성
- `telepty deliberate` 지원 여부 감지
- 지원 시: `telepty deliberate`를 우선 사용
- 미지원 시: `telepty multicast`/`telepty inject` fallback으로 동일 프로토콜 주입
- `from` / `reply-to` 규칙, sub-deliberation 허용, 세션 디렉토리 매핑 자동 포함
- 토론 중 어떤 skill/tool을 먼저 써야 하는지에 대한 routing guide 포함
- 태스크 완료/블로커/장기 대기 상태에 대한 active reporting 규칙 포함
- 자기 영역 밖 핵심 로직 구현 금지 규칙 포함

## 빠른 워크플로우

### 1. 현재 세션과 telepty 기능 감지

먼저 helper script로 상태를 확인합니다:

```bash
python3 skills/telepty-deliberate/scripts/telepty_deliberation_helper.py features
python3 skills/telepty-deliberate/scripts/telepty_deliberation_helper.py discover
```

필수 확인:
- `current_session_id`가 비어 있지 않은지
- `telepty` 명령이 있는지
- `telepty deliberate`가 있는지
- 없으면 `telepty multicast` fallback 가능 여부

`TELEPTY_SESSION_ID`가 없으면:
- 현재 CLI가 telepty 관리 세션이 아닌지 확인
- 필요 시 사용자에게 kickoff를 어느 세션 기준으로 할지 짧게 확인

### 2. 토론 입력 정리

사용자에게서 아래만 확보하면 충분합니다:
- `topic` 또는 `objective`
- 필요한 배경 `context`
- 대상 세션 범위: 기본은 현재 세션을 제외한 모든 활성 세션

추가로 있으면 좋음:
- `thread_id`
- 특정 participant 제한
- 명시적 `reply_to` 세션

### 3. 기본 경로: `kickoff`

helper script는 `kickoff` 명령으로 transport를 자동 선택합니다:

```bash
python3 skills/telepty-deliberate/scripts/telepty_deliberation_helper.py kickoff \
  --topic "..." \
  --context "..." \
  --dry-run
```

실제 전송:

```bash
python3 skills/telepty-deliberate/scripts/telepty_deliberation_helper.py kickoff \
  --topic "..." \
  --context "..."
```

동작 방식:
- `telepty deliberate`가 있으면 그것을 사용
- 없으면 `telepty multicast` fallback 사용
- 현재 telepty가 `--from` / `--reply-to`를 지원하면 point-to-point 질의에는 그것을 우선 사용
- `multicast`는 여전히 본문 prefix 프로토콜을 포함

### 4. 우선 경로: `telepty deliberate`

`features` 결과에서 `has_deliberate=true`면 `kickoff`는 아래 흐름을 사용합니다:

1. `telepty deliberate --help`를 먼저 읽고 실제 인터페이스를 확인
2. helper script가 만든 protocol blob을 임시 context 파일로 저장
3. 가능하면 아래 필드를 넘깁니다:
   - `thread_id`
   - `participants`
   - `objective`
   - `context` file

현재 확인된 telepty 0.1.20 usage는 아래입니다:

```bash
telepty deliberate --topic "..." --sessions s1,s2 --context /tmp/context.txt
```

`telepty deliberate` 인터페이스가 아직 불안정하면 억지로 추측하지 말고 즉시 fallback으로 전환합니다.

### 5. fallback 경로: `telepty multicast`

`telepty deliberate`가 없거나 usage가 확정되지 않았으면 helper script가 만드는 kickoff prompt를 그대로 사용합니다:

```bash
python3 skills/telepty-deliberate/scripts/telepty_deliberation_helper.py kickoff-fallback \
  --topic "..." \
  --context "..." \
  --dry-run
```

`--dry-run` 출력이 맞으면 실제 전송:

```bash

From dmsdc-ai/aigentry-devkit, MIT.

More from dmsdc-ai/aigentry-devkit