@crewx/dreaming 0.1.0-rc.63 → 0.1.0-rc.65

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/SKILL.md +72 -71
  2. package/package.json +3 -3
package/SKILL.md CHANGED
@@ -1,142 +1,143 @@
1
1
  ---
2
2
  name: crewx/dreaming
3
3
  description: >
4
- 선별 실행하는 필수 회고 스킬. 태스크/대화 단위로 에이전트 행동을 되돌아보는
5
- 1급 자기성찰 도구. memory/doc/search와 동급으로 상황 판단해 주도적으로 호출한다.
4
+ Essential retrospective skill invoked selectively. A first-class self-reflection
5
+ tool for reviewing agent behavior at the task/conversation level. On par with
6
+ memory/doc/search — the agent judges the situation and calls it proactively.
6
7
  metadata:
7
8
  version: 0.1.0
8
9
  built-in: true
9
10
  ---
10
11
 
11
- # Dreaming — 필수 회고 스킬
12
+ # Dreaming — Essential Retrospective Skill
12
13
 
13
- **dreaming은 에이전트의 1급 자기성찰 도구다.**
14
- memory(기억 저장/검색), doc(설계서 탐색), search(코드 검색)와 동급으로,
15
- 에이전트가 상황을 판단해 **스스로 호출**한다. 수동 요청이 오기를 기다리지 않는다.
14
+ **dreaming is the agent's first-class self-reflection tool.**
15
+ On par with memory (store/search memories), doc (explore design docs), and search (search code),
16
+ the agent judges the situation and **calls it on its own** — it doesn't wait for a manual request.
16
17
 
17
- ## 두 가지 시야
18
+ ## Two Views
18
19
 
19
- | 명령어 | 시야 | 쓰는 때 |
20
+ | Command | View | When to use |
20
21
  |--------|------|---------|
21
- | `crewx dreaming --task=tsk_xxx` | 돋보기 | 태스크 1건을 깊게 — 행동 타임라인, 삽질 패턴, 효율 패턴, 스킬 사용 현황 |
22
- | `crewx dreaming --thread=thd_xxx --recent=N` | 지도 | 대화 내 최근 N개 태스크 목록 + 각 종료상태 |
23
- | `crewx dreaming --thread=thd_xxx --agent=self --continue` | 이어보기 | 내 직전 작업 1건 상세 + 그 이전 N건 규칙 기반 요약 |
22
+ | `crewx dreaming --task=tsk_xxx` | Magnifier | Deep dive into one task — action timeline, struggle patterns, efficiency patterns, skill usage |
23
+ | `crewx dreaming --thread=thd_xxx --recent=N` | Map | List of the last N tasks in the conversation + each one's end status |
24
+ | `crewx dreaming --thread=thd_xxx --agent=self --continue` | Continue | Detail on my most recent task + rule-based summary of the N before it |
24
25
 
25
- ## 언제 호출할까 (에이전트 판단 기준)
26
+ ## When To Call It (Agent Judgment Criteria)
26
27
 
27
- - **작업 시작 전**: 방금 끊긴 태스크가 있는지 확인 → `--thread` 목록 확인
28
- - **실패 태스크 재시도**: 직전에 어디까지 하다 멈췄는지 → `--task` 로 타임라인 확인
29
- - **대화 맥락 파악**: 이 대화에서 뭘 시켰는지 목록으로 파악 → `--thread --recent=5`
30
- - **작업 후 자기 점검**: 삽질 패턴 / 효율 패턴 확인 → `--task` 로 회고
28
+ - **Before starting work**: Check whether a task was just interrupted → check the `--thread` list
29
+ - **Retrying a failed task**: See where it stopped last time → check the timeline with `--task`
30
+ - **Understanding conversation context**: Get a list of what was asked in this conversation → `--thread --recent=5`
31
+ - **Self-check after a task**: Check for struggle patterns / efficiency patterns → retrospect with `--task`
31
32
 
32
- ## 사용법
33
+ ## Usage
33
34
 
34
35
  ```bash
35
- # 태스크 1건 깊이 회고
36
+ # Deep retrospective on one task
36
37
  crewx dreaming --task=tsk_abc123
37
38
 
38
- # 대화 내 최근 5건 목록 (기본값)
39
+ # List of the last 5 in the conversation (default)
39
40
  crewx dreaming --thread=thd_xyz789
40
41
 
41
- # 더 많이 보기
42
+ # See more
42
43
  crewx dreaming --thread=thd_xyz789 --recent=20
43
44
 
44
- # 특정 태스크 드릴다운
45
+ # Drill down into a specific task
45
46
  crewx dreaming --task=tsk_abc123 --json
46
47
  ```
47
48
 
48
- ## 출력 예시 — --task 모드
49
+ ## Output Example — --task Mode
49
50
 
50
51
  ```
51
52
  ━━━ Dreaming: task tsk_abc123 ━━━
52
53
  Agent: core_dev (acp/claude) | Status: success | Duration: 312s | Tools: 47 calls
53
- 📋 지시: dreaming 빌트인 승격 작업
54
- 📝 결론: packages/built-in/dreaming/ 생성 완료
54
+ 📋 Instruction: promote dreaming to a built-in skill
55
+ 📝 Conclusion: packages/built-in/dreaming/ created successfully
55
56
 
56
- [타임라인]
57
+ [Timeline]
57
58
  1. Read packages/built-in/memory/package.json
58
59
  2. Read packages/built-in/doc/tsconfig.json
59
60
  3. Edit packages/built-in/dreaming/package.json
60
61
  ...
61
62
  41. Bash npx tsc --noEmit → ❌ error TS2345
62
- 42. Edit packages/built-in/dreaming/src/analyzer.ts ← 같은 파일 재수정
63
+ 42. Edit packages/built-in/dreaming/src/analyzer.ts ← re-edited the same file
63
64
  43. Bash npx tsc --noEmit → ✅ pass
64
- 💡 삽질: analyzer.ts 2회 수정 (41→43) — 타입 불일치
65
+ 💡 Struggle: edited analyzer.ts twice (41→43) — type mismatch
65
66
 
66
- [스킬 사용]
67
- crewx/memory 3회 (index, find, save)
68
- crewx/doc 2회 (toc, section)
67
+ [Skill Usage]
68
+ crewx/memory 3x (index, find, save)
69
+ crewx/doc 2x (toc, section)
69
70
 
70
- [회고 요약]
71
- ⚠️ 삽질 패턴: 같은 파일 반복 수정 1건 (analyzer.ts 2회)
72
- 💡 인사이트: 에러 대부분 타입 불일치 (1건)
73
- 🔍 코드 분석 활용 — tsserver 5회 사용
71
+ [Retrospective Summary]
72
+ ⚠️ Struggle pattern: repeated edits to the same file, 1 case (analyzer.ts x2)
73
+ 💡 Insight: most errors were type mismatches (1 case)
74
+ 🔍 Used code analysis — tsserver called 5x
74
75
  ```
75
76
 
76
- ## 출력 예시 — --thread 모드
77
+ ## Output Example — --thread Mode
77
78
 
78
79
  ```
79
- ━━━ Dreaming: thread thd_xyz789 — 최근 5건 ━━━
80
- 태스크 목록: 5건
80
+ ━━━ Dreaming: thread thd_xyz789 — last 5 ━━━
81
+ Task list: 5
81
82
 
82
- 1. ✅ tsk_abc123 | core_dev | success | 312s | dreaming 빌트인 승격 작업
83
- 2. ❌ tsk_def456 | core_dev | failed | 45s | tsc 빌드 검증
84
- 3. ✅ tsk_ghi789 | ui_lead | completed | 180s | UI 컴포넌트 리뷰
85
- 4. ✅ tsk_jkl012 | core_dev | success | 240s | SDK 리포지토리 패턴 적용
86
- 5. ✅ tsk_mno345 | core_dev | success | 90s | CLI registry 등록
83
+ 1. ✅ tsk_abc123 | core_dev | success | 312s | promote dreaming to a built-in skill
84
+ 2. ❌ tsk_def456 | core_dev | failed | 45s | tsc build verification
85
+ 3. ✅ tsk_ghi789 | ui_lead | completed | 180s | UI component review
86
+ 4. ✅ tsk_jkl012 | core_dev | success | 240s | apply SDK repository pattern
87
+ 5. ✅ tsk_mno345 | core_dev | success | 90s | register CLI registry
87
88
 
88
- 드릴다운: crewx dreaming --task=<id>
89
+ Drill down: crewx dreaming --task=<id>
89
90
  ```
90
91
 
91
- ## 출력 예시 — --continue 모드 (이전 내 작업 이어보기)
92
+ ## Output Example — --continue Mode (Continue My Previous Work)
92
93
 
93
- 같은 thread 안에서 **현재 agent 자신의** 이전 작업만 골라, 최신 1건은 자세히 + 그 이전은 규칙 기반 한 줄 요약으로 보여준다. 요약은 LLM이 아니라 tool count / status / duration / files 기반이다.
94
+ Within the same thread, this picks out only the **current agent's own** previous work, showing the most recent one in detail plus rule-based one-line summaries of the ones before it. The summaries are based on tool count / status / duration / files, not an LLM.
94
95
 
95
96
  ```
96
- ━━━ 이전 내 작업 이어보기 ━━━
97
+ ━━━ Continue My Previous Work ━━━
97
98
  Thread: thd_xyz789 | Agent: core_lead
98
99
 
99
- [직전 작업]
100
+ [Most Recent Task]
100
101
 
101
102
  ━━━ Dreaming: task tsk_123 ━━━
102
- ... 자세한 활동 기록 (타임라인 캡 30, --full로 해제) ...
103
+ ... detailed activity log (timeline capped at 30, remove with --full) ...
103
104
 
104
- [이전 작업 요약]
105
- - tsk_122 | ✅ success | 120s | Bash 3회, Read 4회, Edit 0회
106
- - tsk_121 | ❌ failed | 45s | Bash 2회 | ⚠️ 삽질
105
+ [Previous Task Summary]
106
+ - tsk_122 | ✅ success | 120s | Bash 3x, Read 4x, Edit 0x
107
+ - tsk_121 | ❌ failed | 45s | Bash 2x | ⚠️ struggle
107
108
 
108
- ━━━ 다음 액션 ━━━
109
- 전체 활동 기록:
109
+ ━━━ Next Actions ━━━
110
+ Full activity log:
110
111
  crewx dreaming --task=tsk_122 --full
111
- 상세 작업 기록 JSON:
112
+ Detailed task log JSON:
112
113
  crewx dreaming --task=tsk_122 --json
113
- 이 대화 작업 목록:
114
+ Task list for this conversation:
114
115
  crewx dreaming --thread=thd_xyz789 --agent=core_lead
115
116
  ```
116
117
 
117
118
  ```bash
118
- # 현재 agent 자신의 이전 작업 이어보기
119
+ # Continue the current agent's own previous work
119
120
  crewx dreaming --thread=thd_xyz789 --agent=self --continue
120
121
 
121
- # 명시 agent + 최근 3건 (최신 1 상세 + 이전 2 요약)
122
+ # Explicit agent + last 3 (most recent 1 detailed + previous 2 summarized)
122
123
  crewx dreaming --thread=thd_xyz789 --agent=core_lead --continue --recent=3
123
124
  ```
124
125
 
125
- > `--agent=self` 는 `CREWX_AGENT_ID` 환경변수로 현재 agent를 해석한다. 환경변수가 없으면 명시 agent id를 써야 한다.
126
+ > `--agent=self` resolves the current agent via the `CREWX_AGENT_ID` environment variable. If the variable isn't set, you must specify an explicit agent id.
126
127
 
127
128
  ## Options
128
129
 
129
- | 옵션 | 기본값 | 설명 |
130
+ | Option | Default | Description |
130
131
  |------|--------|------|
131
- | `--task=ID` | — | 태스크 ID (tsk_xxx) |
132
- | `--thread=ID` | — | 스레드 ID (thd_xxx) |
133
- | `--agent=ID` | — | thread 안에서 특정 agent만 (`self` → 현재 agent) |
134
- | `--continue` | false | 이전 내 작업 이어보기 (최신 1 상세 + 이전 N 규칙 요약) |
135
- | `--recent=N` | 목록 5 / continue 3 | 최근 N건 |
136
- | `--full` | false | 타임라인 캡 해제 + JSON에 raw 필드 포함 |
137
- | `--json` | false | 순수 JSON 출력 (CAL footer 없음) |
138
-
139
- ## CAL "다음 액션"
140
-
141
- human 출력 하단에는 다음 행동을 안내하는 CAL footer가 붙는다 (`--full`, `--json`, thread 드릴다운).
142
- **`--json` 출력에는 footer가 붙지 않으며 단일 JSON으로 파싱 가능하다.** `--full` 없이는 JSON에서 원본 입력/결과 필드를 제외한다.
132
+ | `--task=ID` | — | Task ID (tsk_xxx) |
133
+ | `--thread=ID` | — | Thread ID (thd_xxx) |
134
+ | `--agent=ID` | — | Only this agent within the thread (`self` → current agent) |
135
+ | `--continue` | false | Continue my previous work (most recent 1 detailed + previous N rule-based summary) |
136
+ | `--recent=N` | list 5 / continue 3 | Last N items |
137
+ | `--full` | false | Remove the timeline cap + include raw fields in JSON |
138
+ | `--json` | false | Pure JSON output (no CAL footer) |
139
+
140
+ ## CAL "Next Actions"
141
+
142
+ A CAL footer guiding the next action is appended to the bottom of human-readable output (`--full`, `--json`, thread drill-down).
143
+ **The `--json` output has no footer and can be parsed as a single JSON value.** Without `--full`, the raw input/result fields are excluded from the JSON.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@crewx/dreaming",
3
- "version": "0.1.0-rc.63",
3
+ "version": "0.1.0-rc.65",
4
4
  "description": "Dreaming — mandatory retrospection skill for CrewX agents (task/thread review)",
5
5
  "type": "commonjs",
6
6
  "main": "dist/cli.js",
@@ -31,8 +31,8 @@
31
31
  ],
32
32
  "license": "MIT",
33
33
  "dependencies": {
34
- "@crewx/sdk": "0.9.0-rc.38",
35
- "@crewx/shared": "0.0.6"
34
+ "@crewx/shared": "0.0.6",
35
+ "@crewx/sdk": "0.9.0-rc.40"
36
36
  },
37
37
  "devDependencies": {
38
38
  "@types/node": "^20.0.0",