teamai-cli 0.25.0-beta.6 → 0.26.0-beta.0

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 (49) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.ja.md +26 -227
  3. package/README.ko.md +26 -227
  4. package/README.md +26 -227
  5. package/README.th.md +26 -227
  6. package/README.zh-CN.md +32 -227
  7. package/dist/index.js +5885 -3199
  8. package/package.json +4 -1
  9. package/skill-data/core/SKILL.md +114 -0
  10. package/skill-data/core/references/commands.md +339 -0
  11. package/{skills/teamai → skill-data/core}/references/contribute-member.md +13 -10
  12. package/{skills/teamai → skill-data/core}/references/troubleshooting.md +1 -1
  13. package/skill-data/setup/SKILL.md +76 -0
  14. package/{skills/teamai → skill-data/setup}/references/join-member.md +21 -20
  15. package/{skills/teamai → skill-data/setup}/references/manage-admin.md +8 -6
  16. package/skill-data/setup/references/provider-tgit.md +78 -0
  17. package/{skills/teamai → skill-data/setup}/references/setup-admin.md +49 -93
  18. package/skill-data/share/SKILL.md +70 -0
  19. package/skill-data/share/references/doc-template.md +44 -0
  20. package/skill-data/wiki/SKILL.md +314 -0
  21. package/skill-data/wiki/references/agents/graph-rag-agent.md +344 -0
  22. package/skill-data/wiki/references/agents/kb-doc-generator.md +323 -0
  23. package/skill-data/wiki/references/methodology/phase0-collection.md +54 -0
  24. package/skill-data/wiki/references/methodology/phase1-reverse-engineering.md +89 -0
  25. package/skill-data/wiki/references/methodology/phase2-document-types.md +341 -0
  26. package/skill-data/wiki/references/methodology/phase3-ai-enhancement.md +164 -0
  27. package/skill-data/wiki/references/methodology/phase4-quality.md +232 -0
  28. package/skill-data/wiki/references/overview.md +124 -0
  29. package/skill-data/wiki/references/phases/k1-reverse-engineering.md +118 -0
  30. package/skill-data/wiki/references/phases/k2-documents.md +68 -0
  31. package/skill-data/wiki/references/phases/k3-ai-native.md +121 -0
  32. package/skill-data/wiki/references/phases/k4-quality.md +190 -0
  33. package/skill-data/wiki/references/phases/phase0-init.md +112 -0
  34. package/skill-data/wiki/references/templates/project-overview.md +148 -0
  35. package/{skills/team-wiki-codebase → skill-data/wiki}/scripts/scan_repo.py +52 -52
  36. package/{skills/team-wiki-codebase → skill-data/wiki}/scripts/validate_kb.py +68 -62
  37. package/skills/teamai/SKILL.md +28 -134
  38. package/skills/team-wiki-codebase/README.md +0 -121
  39. package/skills/team-wiki-codebase/SKILL.md +0 -905
  40. package/skills/team-wiki-codebase/references/agents/graph-rag-agent.md +0 -344
  41. package/skills/team-wiki-codebase/references/agents/kb-doc-generator.md +0 -323
  42. package/skills/team-wiki-codebase/references/methodology/phase0-collection.md +0 -54
  43. package/skills/team-wiki-codebase/references/methodology/phase1-reverse-engineering.md +0 -89
  44. package/skills/team-wiki-codebase/references/methodology/phase2-document-types.md +0 -341
  45. package/skills/team-wiki-codebase/references/methodology/phase3-ai-enhancement.md +0 -164
  46. package/skills/team-wiki-codebase/references/methodology/phase4-quality.md +0 -232
  47. package/skills/team-wiki-codebase/references/templates/project-overview.md +0 -148
  48. package/skills/teamai-share-learnings/SKILL.md +0 -87
  49. /package/{skills/teamai → skill-data/setup}/references/uninstall.md +0 -0
package/README.ko.md CHANGED
@@ -23,15 +23,11 @@
23
23
 
24
24
  TeamAI는 개인의 AI 역량을 팀 공동의 역량으로 바꾸고, 여러 Agent와 기기, 팀원 전반에서 활용할 수 있게 합니다.
25
25
 
26
- ## 기여자
27
-
28
- TeamAI에 기여해 주신 모든 분께 감사합니다!
29
-
30
- <a href="https://github.com/Tencent/teamai-cli/graphs/contributors">
31
- <img src="https://contrib.rocks/image?repo=Tencent/teamai-cli" alt="Contributors" />
32
- </a>
26
+ ## 왜 TeamAI인가
33
27
 
34
- [contrib.rocks](https://contrib.rocks)로 생성했습니다.
28
+ <p align="center">
29
+ <img src="assets/use-cases.png" alt="일상적인 8가지 상황: TeamAI 도입 전과 후" width="100%">
30
+ </p>
35
31
 
36
32
  ## 빠른 시작
37
33
 
@@ -52,10 +48,12 @@ TeamAI를 설정한 뒤에는 AI 도구에서 `/teamai` skill에게 말만 걸
52
48
  **팀 참여**
53
49
 
54
50
  ```text
55
- /teamai 우리 팀의 TeamAI에 참여하고 싶어, 저장소 URL은 https://github.com/yourorg/yourrepo
51
+ /teamai 우리 팀의 TeamAI에 참여하고 싶어, 저장소 URL은 https://github.com/your-org/your-repo
56
52
  ```
57
53
 
58
- **skill을 팀에 공유**
54
+ **팀에 공유하기**
55
+
56
+ Skills, Rules, MCP 등 Agent가 사용할 수 있는 리소스는 모두 공유할 수 있습니다:
59
57
 
60
58
  ```text
61
59
  /teamai xxx skill을 팀에 공유해줘
@@ -68,7 +66,7 @@ TeamAI를 설정한 뒤에는 AI 도구에서 `/teamai` skill에게 말만 걸
68
66
  ```
69
67
 
70
68
  <details>
71
- <summary>명령줄이 더 편한가요? (수동 설치)</summary>
69
+ <summary>명령줄 설치</summary>
72
70
 
73
71
  ### 설치
74
72
 
@@ -78,7 +76,7 @@ npm install -g teamai-cli
78
76
 
79
77
  ### 팀 관리자 / 개인 사용자
80
78
 
81
- Git 호스트(GitHub, GitLab, GitCode, CNB, TGit 또는 비공개 Git 서비스)에 공유 경험 저장소를 만들고, **팀원에게 쓰기 권한을 부여한 뒤** `teamai init https://github.com/yourorg/yourrepo`를 실행하세요.
79
+ Git 호스트(GitHub, GitLab, GitCode, CNB, TGit 또는 비공개 Git 서비스)에 공유 경험 저장소를 만들고, **팀원에게 쓰기 권한을 부여한 뒤** `teamai init https://github.com/your-org/your-repo`를 실행하세요.
82
80
 
83
81
  > **아직 팀 저장소가 없나요?** 프로덕션에 바로 쓸 수 있는 Skills, Rules, review agents가 미리 들어 있는 템플릿으로 시작하세요. [teamai-hub](https://github.com/teamai-hub) org를 둘러본 뒤 **Fork**하고, 새로 만든 저장소에 `teamai init`을 실행하면 됩니다.
84
82
 
@@ -89,237 +87,38 @@ Git 호스트(GitHub, GitLab, GitCode, CNB, TGit 또는 비공개 Git 서비스)
89
87
 
90
88
  # Project-scope init (default, resources installed under the project directory)
91
89
  cd /path/to/my-project
92
- teamai init https://github.com/yourorg/yourrepo
90
+ teamai init https://github.com/your-org/your-repo
93
91
 
94
92
  # Or, user-scope init (resources installed under ~/)
95
- teamai init https://github.com/yourorg/yourrepo --scope user
93
+ teamai init https://github.com/your-org/your-repo --scope user
96
94
  ```
97
95
 
98
96
  초기화가 끝나면 관리자가 배포한 최신 Skills / Rules 및 기타 Harness 업데이트가 매 AI 세션에서 자동으로 반영됩니다. 수동 동기화는 필요 없습니다.
99
97
 
100
98
  </details>
101
99
 
102
- > **전체 사용 가이드:** [docs/usage-guide.md](docs/usage-guide.md) ([中文版](docs/usage-guide.zh-CN.md)) — 팀 생성부터 일상 사용까지 모두 다룹니다.
103
-
104
- ## 제품 아키텍처
105
-
106
- **Team Execution × Team Context (beta) × Team Improvement (beta)**:
107
-
108
- | 계층 | 역할 | 현재 CLI에서 |
109
- |-------|-----|-------------------|
110
- | **Team Execution** | 모든 Agent가 팀의 방식대로 일하게 합니다 | `init` / `pull` / `push`, skills, rules, agents, hooks, MCP, env |
111
- | **Team Context** (beta) | 모든 Agent가 팀을 이해하게 합니다 | recall, learnings, codebase graph, teamwiki... |
112
- | **Team Improvement** (beta) | 모든 실행이 팀을 더 강하게 만듭니다 | 마찰 기반 share-learnings, sessions, digest, dashboard... |
113
-
114
- ## 개요
115
-
116
- <table>
117
- <thead>
118
- <tr>
119
- <th rowspan="2">Agent</th>
120
- <th colspan="7">Team Execution</th>
121
- <th colspan="3">Team Context (beta)</th>
122
- <th colspan="3">Team Improvement (beta)</th>
123
- </tr>
124
- <tr>
125
- <th>skills</th><th>rules</th><th>docs</th><th>env</th><th>agents</th><th>hooks</th><th>mcp</th>
126
- <th>learnings</th><th>codebase</th><th>teamwiki</th>
127
- <th>usage</th><th>sessions</th><th>dashboard</th>
128
- </tr>
129
- </thead>
130
- <tbody>
131
- <tr><td>Claude Code</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
132
- <tr><td>Codex</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
133
- <tr><td>Cursor</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
134
- <tr><td>GitHub Copilot CLI</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
135
- <tr><td>CodeBuddy</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
136
- <tr><td>WorkBuddy</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
137
- <tr><td>OpenCode</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
138
- <tr><td>OpenClaw</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
139
- <tr><td>Hermes</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
140
- <tr><td>DeepSeek Harness</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
141
- <tr><td>Qoder</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
142
- <tr><td>Kiro</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
143
- <tr><td>ZCode</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
144
- <tr><td>Oh My Pi</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
145
- </tbody>
146
- </table>
147
-
148
- **Git providers** — GitHub · GitLab · GitCode · CNB · TGit · 비공개 Git 서비스.
149
-
150
- ### 배포 제어
151
-
152
- 관리자가 한 번 설정하면 `teamai pull` 때 모든 멤버에게 전달되는 팀 전역 설정입니다.
153
-
154
- | 기능 | 명령 | 하는 일 |
155
- |------------|---------|--------------|
156
- | **Projects** | `teamai projects` | 작업 디렉터리를 하나 이상의 논리 프로젝트에 묶어, 해당 프로젝트의 Skills, 지식, 격리된 learnings를 동기화합니다. Roles와는 별개의 차원입니다. |
157
- | **Roles** | `teamai roles` | role → namespace 매핑을 정의해, 각 멤버가 자신의 role에 해당하는 Skills만 동기화하게 합니다. |
158
- | **Tags** | `teamai tags` | Skills / Rules에 태그를 달아, 멤버가 필요한 태그만 구독하게 합니다. |
159
- | **Sources** | `teamai source` | 추가 skill 저장소를 구독합니다 — 다른 팀의 공개 저장소, 또는 우리 org 안의 공유/공개 저장소. 구독한 Skills는 pull 때 자동 동기화됩니다. |
160
-
161
- Learnings 격리: 저장소 루트의 `learnings/`는 전원과 공유되고, `learnings/<project-id>/`는 프로젝트 전용입니다. [usage guide](docs/usage-guide.md#multi-project-project-as-a-dimension-orthogonal-to-role)를 참고하세요.
162
-
163
- ## Team Execution
164
-
165
- > One Team. One Harness. Every Agent.
166
-
167
- TeamAI는 Skills, Rules, docs, hooks를 공유 Git 저장소에 두고, "push → review & merge → pull" 흐름으로 각 멤버의 로컬 AI 도구에 배포합니다. 다른 팀이나 공유 저장소의 Harness 구독도 지원합니다.
168
-
169
- ### 작동 방식
170
-
171
- ```
172
- teamai push → create branch + MR → reviewer approves + merges
173
- ↓
174
- SessionStart hook → teamai pull → synced to local AI tools
175
- ```
176
-
177
- ### 공유되는 항목
178
-
179
- 각 리소스는 모든 Agent에 전달됩니다.
180
-
181
- | 리소스 | 팀 저장소 위치 | 참고 |
182
- |----------|------------------|-------|
183
- | **Skills** | `skills/<name>/SKILL.md` | |
184
- | **Rules** | `rules/*.md` | |
185
- | **Docs** | `docs/` | 프로젝트 기반 문서. 기본값으로 전부 로드되지는 않습니다(progressive disclosure) |
186
- | **Agents** | `agents/<name>.yaml` | |
187
- | **Culture** | `culture.md` | 팀의 미션, 가치, 일하는 원칙 — 각 Agent의 CLAUDE.md / AGENTS.md에 주입되어 모든 세션이 이를 이어받습니다 |
188
- | **CLAUDE.md** | `claudemd/*.md` | |
189
- | **Env** | `env/` | 팀 단위 공유 환경 변수와 스위치. 시크릿은 넣지 마세요 |
190
- | **Hooks** | `hooks/hooks.yaml` | 각 hook에 `roles:`를 달면 해당 role을 가진 멤버에게만 전달됩니다 |
191
- | **MCP** | `mcp/mcp.yaml` | 각 server에 `roles:`를 달면 해당 role을 가진 멤버에게만 전달됩니다 |
192
- | **Packages** | `teamai.yaml` | 현재는 npm 패키지와 Claude Code 플러그인만 지원 |
193
- | **Models** | — | 아직 모든 provider에 구현되지 않았습니다 |
194
-
195
- 파일 형식과 전체 워크플로는 [Usage Guide](docs/usage-guide.md)를 참고하세요.
196
-
197
- ## Team Context (beta)
198
-
199
- > Every agent understands how the team works.
200
-
201
- Harness를 배포하는 것을 넘어, TeamAI는 쌓인 팀 경험과 코드 구조를 검색 가능한 지식 베이스로 정리하고, AI가 필요할 때 자동으로 불러오게 합니다.
202
-
203
- ### 경험 자동 공유
204
-
205
- 세션이 끝나면 Stop hook이 **friction**(마찰)으로 점수를 매깁니다. 세션에서 기억할 만한 일이 있었음을 나타내는 신호입니다. 예를 들어 AI를 중단하거나 고쳤거나, 도구 호출을 거절했거나, AI가 실패한 도구를 여러 번 재시도한 경우입니다. 도구 호출은 많지만 마찰이 없는 길고 평범한 세션은 트리거되지 않고, 실제로 문제를 붙잡고 씨름한 세션만 해당합니다. 점수가 충분하면 AI가 이렇게 제안합니다.
206
-
207
- ```
208
- [teamai] This session may contain a problem worth documenting: you interrupted the AI twice, the AI retried failing tools 8 times.
209
-
210
- Task: Fix duplicate project-level Hook injection
211
-
212
- Consider running /teamai-share-learnings to summarize what you learned and share it with your team.
213
- ```
214
-
215
- 힌트에는 트리거가 된 0이 아닌 friction 신호가 나오고, 가능하면 첫 번째 작업을 마스킹한 한 줄 요약도 붙습니다. `/teamai-share-learnings` skill은 세션을 요약해 learning 문서를 팀 저장소에 바로 push합니다. 세션당 힌트는 최대 한 번입니다. 팀은 `teamai.yaml`에서 `sharing.contributeHint.enabled: false`로 힌트만 끌 수 있고(멤버는 로컬 설정의 `contributeHintEnabled`), Stop hook의 나머지 기능은 그대로 둡니다.
216
-
217
- ### 팀 지식 Recall
100
+ ## 자세히 알아보기
218
101
 
219
- 작업 전에 AI가 쌓인 팀 지식을 자동으로 검색하게 합니다. 이 기능은 **기본값이 꺼짐**이며, 명시적으로 켜야 합니다. 팀은 `teamai.yaml`에서 `sharing.recall.enabled: true`를 기본값으로 둘 수 있고, 멤버는 로컬에서 덮어쓸 수 있습니다.
102
+ - [Usage Guide](docs/usage-guide.md) — setup, onboarding, daily workflows, and commands
103
+ - [Product Overview](docs/product-overview.md) — architecture, capabilities, and agent support
104
+ - [Git Providers](docs/providers.md) — supported repository providers
105
+ - [Windows Setup](docs/windows-hooks.md) — hooks and shell configuration
106
+ - [Technical Designs](docs/designs/) — design documents and proposals
220
107
 
221
- ```bash
222
- teamai recall enable # on: deploy the teamai-recall subagent + inject guidance rules
223
- teamai recall disable # off: remove the subagent and rules
224
- teamai recall status # show effective state (team default + user override)
225
- ```
226
-
227
- **검색은 subagent로 실행됩니다**: 켜면 `teamai pull`이 내장 `teamai-recall` subagent를 각 AI 도구의 `agents/` 디렉터리에 배포합니다. AI는 작업 전에 이를 호출하고, subagent가 키워드를 뽑고, 검색을 돌리고, 맞은 원본 파일을 읽은 뒤 팀 지식의 구조화된 요약을 돌려줍니다. subagent는 먼저 관련성 사전 검사(`teamai recall --check`)를 하고, 작업이 팀 지식과 무관하면 검색을 아예 건너뜁니다. 내부적으로는 `teamai recall` 명령을 호출하며, 직접 실행할 수도 있습니다.
228
-
229
- ```bash
230
- $ teamai recall "port conflict"
231
- [1/2] MR review caught a port-conflict bug ★1 [user]
232
- Author: member-a | Score: 18.5 | Tags: troubleshooting, networking
233
-
234
- [2/2] Deployment configuration best practices [project]
235
- Author: member-b | Score: 12.0 | Tags: deploy, config
236
- Matched: conflict | Missing: port
237
- ```
238
-
239
- ### 코드베이스 지식 그래프
240
-
241
- `teamai import`는 소스 저장소를 `teamwiki/` 아래의 구조화된 그래프로 파싱해, 구조를 아는 검색을 가능하게 합니다.
242
-
243
- ```bash
244
- teamai import --from-repo https://github.com/org/repo
245
- teamai import --from-org myorg # batch import all repos
246
- teamai codebase --extract /path/to/repo # local extract into teamwiki/
247
- teamai codebase --deep-enrich --project my-service --output /path/to/repo # generate deep knowledge docs
248
- teamai codebase --reconcile --output /path/to/repo # map product docs to code pages
249
- teamai codebase --lint --output /path/to/repo # check the locally extracted graph
250
- ```
251
-
252
- Extract는 AI enrichment를 건너뛰거나 결과가 없어도 `teamwiki/evidence/code/<project>/_manifest.json`을 쓰므로 `--deep-enrich`를 이어서 시작할 수 있습니다.
253
-
254
- 그래프는 컴포넌트, 인터페이스, 설정, 저장소 간 import 엣지를 저장합니다. `teamai recall`은 이를 그래프 부스팅 재랭킹에 사용합니다.
255
- recall 결과가 codebase 페이지에서 온 경우, 결과에는 관련 소스 파일 경로를 나열하는 `Sources:` 줄이 포함됩니다. Agent가 저장소를 다시 탐색하지 않고 코드 변경의 출발점을 바로 잡을 수 있습니다.
256
-
257
- 엣지는 함께 도는 두 트랙에서 나오며, 겹치면 AST 결과가 우선합니다.
258
-
259
- - **AST track** (TypeScript/JavaScript, Python, Go): WASM [tree-sitter](https://tree-sitter.github.io/) 파서가 `import`/`require`, 호출 지점, TS `implements` 절을 파일 간 정확한 `DEPENDS_ON` / `REFERENCES` / `IMPLEMENTS` 엣지로 해석합니다(`code-ast` 태그, confidence 가중치).
260
- - **Heuristic track** (Java/Rust를 포함한 모든 언어): 정규식 기반 추출(`code-heuristic` 태그). AST track이 다루지 않는 언어도 커버합니다.
261
-
262
- WASM 파서는 순수 JavaScript 의존성이라 네이티브 툴체인이 필요 없습니다. 어떤 이유로든 로드에 실패하면 추출은 heuristic track으로 떨어지고 `AST_UNAVAILABLE` gap을 기록합니다. `TEAMAI_SKIP_AST=1`을 설정하면 heuristic 전용 추출을 강제합니다.
263
-
264
- ## Team Improvement (beta)
108
+ ## 기여자
265
109
 
266
- > Every execution makes the entire team smarter.
110
+ TeamAI에 기여해 주신 모든 분께 감사합니다!
267
111
 
268
- ### Maintenance
112
+ <a href="https://github.com/Tencent/teamai-cli/graphs/contributors">
113
+ <img src="https://contrib.rocks/image?repo=Tencent/teamai-cli" alt="Contributors" />
114
+ </a>
269
115
 
270
- Skills와 지식이 쌓이면, 팀이 더 이상 쓰지 않는 것을 정리하세요. `teamai recall maintenance`는 신뢰도가 낮은 learnings를 아카이브하고, 낡은 Skills, Rules, docs를 정리 또는 업데이트 대상으로 표시합니다.
116
+ [contrib.rocks](https://contrib.rocks)로 생성했습니다.
271
117
 
272
- ```bash
273
- teamai recall maintenance --prune --dry-run # preview
274
- teamai recall maintenance --prune --archive # archive unused learnings
275
- teamai recall maintenance --update-quality # draft updates for stale skills / docs
276
- ```
118
+ ## 기여하기
277
119
 
278
- 팀이 AI 도구를 실제로 어떻게 쓰는지 보고, 세션 friction을 공유 Skills, Rules, 지식으로 바꾸는 출발점입니다.
279
-
280
- | 기능 | 명령 | 보여주는 것 |
281
- |------------|---------|---------------|
282
- | **Usage** | `teamai digest` | 주간 팀 digest — 7일간의 성공률, prompt, 활성 시간, 추정 비용, cache, 수정 추세와 누적 합계. |
283
- | **Sessions** | `teamai session save` | 개인정보를 제거한 세션별 요약(도구 순서, prompt 턴, 개입)으로 digest의 Session Highlights에 들어갑니다. |
284
- | **Dashboard** | `teamai dashboard` | Overview / Team Execution / Team Context / Team Improvement 통합 화면. 로컬 실시간 세션, 7일 추세, 세션당 예상 비용, 영어/중국어 간체 및 밝게/어둡게/시스템 테마를 지원합니다. |
285
- | **KB Health** | `teamai dashboard` → Team Context / Team Improvement | 지식 베이스 사용량과 건강 상태를 보여주는 내장 dashboard 페이지 — 유형별 커버리지, 상위 recall 항목, 침묵 항목, recall 추세, 작성자 기여, maintenance 콘솔. |
286
-
287
- ## 명령어
288
-
289
- | 명령 | 설명 |
290
- |---------|-------------|
291
- | `teamai init` | 초기화: OAuth 로그인, 저장소 연결, 멤버 등록, hooks 주입 |
292
- | `teamai pull` | 팀 리소스를 가져와 로컬 AI 도구에 주입 |
293
- | `teamai push` | 로컬 리소스를 브랜치에 push하고 Merge Request를 엽니다 |
294
- | `teamai packages [install] [target]` | 선언된 npm 패키지와 Claude 플러그인을 설치합니다. target이 있으면 `teamai.yaml`도 갱신합니다. 인자 없는 `teamai packages`는 전부를 설치하고, `teamai packages install <target>`은 하나를 추가합니다 |
295
- | `teamai status` | 로컬과 팀 저장소의 diff 및 리소스 개수(네임스페이스 Skills, 중첩 docs 포함)를 표시 |
296
- | `teamai contribute` | 세션 경험을 팀 저장소의 `teamai-learnings` 브랜치에 공유 |
297
- | `teamai recall <query>` | 팀 지식 베이스 검색 (BM25 + graph-boost) |
298
- | `teamai recall enable/disable/status` | recall 상태를 켜거나 끄거나 확인 |
299
- | `teamai recall promote [learningId]` | 신뢰도가 높은 learning을 정식 지식(skills/rules/docs)으로 승격 |
300
- | `teamai recall maintenance` | 지식 베이스 건강 유지: 신뢰도가 낮은 learnings 정리, confidence 점수 되쓰기, 낡은 항목 표시 |
301
- | `teamai import` | 지식 가져오기 (`--dir`, `--from-repo`, `--from-org`, `--from-repo-list`, `--from-mr`) |
302
- | `teamai codebase --extract [path]` | 코드 사실을 추출하고 `teamwiki/` 아래 로컬 그래프를 구축 |
303
- | `teamai codebase --deep-enrich` | 추출된 evidence로 심층 지식 문서 생성 |
304
- | `teamai codebase --reconcile` | 제품 문서를 추출된 코드 지식과 맞추기 |
305
- | `teamai codebase --lint` | 지식 그래프 건강 검사 |
306
- | `teamai ci extract-mr --url <url>` | CI: MR에서 지식 추출, 댓글 게시, 머지 후 기록 |
307
- | `teamai members` | 팀 멤버 목록 |
308
- | `teamai projects` | 작업 디렉터리를 하나 이상의 논리 프로젝트에 연결 |
309
- | `teamai roles` | 팀 roles와 namespaces 관리 |
310
- | `teamai tags` | 태그 기반 skill/rule 필터 관리 |
311
- | `teamai skill exclude add/remove/list` | 로컬 동기화에서 제외할 Skills 관리 ([usage guide](docs/usage-guide.md#excluding-skills-you-dont-need)) |
312
- | `teamai source` | skill 구독 소스 관리(다른 팀 또는 org의 공유 저장소) |
313
- | `teamai remove <type> <name>` | 리소스를 제거하고 MR을 엽니다 |
314
- | `teamai session save` | 개인정보를 제거한 세션 요약을 월별 로그에 기록 (`--push`는 `digest`에 공급) |
315
- | `teamai digest` | 주간 팀 사용 digest 생성 |
316
- | `teamai doctor` | 구성 문제 진단 (`--json`으로 JSON 출력, CI·hook·agent용) |
317
- | `teamai uninstall` | 모든 teamai 리소스와 hooks 제거 |
120
+ 커뮤니티 참여, Issue, PR을 환영합니다. 기여 방법은 [CONTRIBUTING.md](.github/CONTRIBUTING.md)를 참고하세요.
318
121
 
319
122
  ## 라이선스
320
123
 
321
124
  [MIT](LICENSE)
322
-
323
- ## 기여하기
324
-
325
- PR을 환영합니다! 먼저 [CONTRIBUTING.md](.github/CONTRIBUTING.md)를 읽어 주세요.