Imported from zzsza/openai-dots-progress-board (
AGENTS.md). Install upstream withnpx skills add zzsza/openai-dots-progress-board. Copyright stays with the author.
OpenAI Dots Progress Board
보드 연동
사용자가 자신의 보드에 진행상황 기록을 요청했고 그 보드의 MCP 도구가 연결되어 있으면, 사용자 요청의 시작과 의미 있는 진행 변화, 응답 대기, 완료 시 보드를 갱신한다. 이 저장소의 개발 작업도 같은 방식으로 기록한다.
- 먼저 연결된
list_activity로 기존 기록을 확인하고 같은 목표는 같은 작업 ID로 이어간다. report_activity로 실제로 확인한 마지막 행동과 다음 행동을 기록한다. 실행 전은planned, 실제 실행 중은working, 사용자 응답이나 외부 조건이 필요한 경우는waiting, 완료를 확인한 뒤에는done을 사용한다.- 대기할 때는
waitingFor에 필요한 답변이나 조건을 구체적으로 기록한다. - 첫 연결은 보고 후
get_activity로 읽어 저장을 확인한다. 연결 검증 뒤에는 반복 조회를 불필요하게 수행하지 않는다. - 전체 대화 원문이나 인증값을 보드에 저장하지 않는다.
- 원본 작업이나 예약을 읽지 못했으면 그 사실을 밝힌다. 알고 있지 않은 상태, 주기, 다음 실행 시각을 추측해서 채우지 않는다.
- 보드 연결은 기존 Dots 예약이나 다른 대화의 자동 조회 권한을 주지 않는다. 실제 조회 도구가 있을 때만 기존 목록을 읽고 보고한다.
- 보드 도구가 없는 환경에서는 등록했다고 말하지 않는다.
이 지침은 이 저장소에서 작업하는 에이전트에 적용된다. 다른 Dots 대화에서 같은 루틴을 쓰려면 README의 대화 지침을 해당 Dots에 설정한다.
개발
Node.js 24 이상을 권장한다. 동작을 바꾸면 npm test, npm run typecheck, npm run build로 확인한다. 문서와 캡처만 바꾸면 링크와 이미지 확인으로 충분하다.
GitHub 템플릿의 .openai/hosting.json에는 개인 Site ID를 넣지 않는다. 운영 인스턴스는 소유자별 비공개 Sites로 배포한다. 사용자 기록과 로컬 DB, 인증값을 커밋하지 않는다.
