Question 1

claude-code-templates 애널리틱스에서 Agent Usage Distribution, Agent Activity Timeline, Workflow Efficiency Score가 비어 있는 이유는 무엇인가요?

Accepted Answer

claude-code-templates v1.28.16에서는 분석 코드가 `Task`라는 이름의 도구 호출만 인식하지만, Claude Code JSONL 로그는 에이전트 도구 호출을 `Agent`로 기록합니다. 두 이름을 모두 허용하도록 필터를 업데이트하세요. `AgentAnalyzer.js`(약 72행), `chats-mobile.js`(약 606행), `teams-dashboard.js`(약 306, 360, 467행)에서 다음 코드를:

```js
content.name === 'Task'
```

다음과 같이 교체하세요:

```js
(content.name === 'Task' || content.name === 'Agent')
```

이 변경 사항을 해당 파일의 모든 에이전트 관련 비교에 적용한 후, 다음을 다시 실행하세요:

```bash
npx claude-code-templates@latest --analytics
```

`npx`를 통해 실행하는 경우, 수정 사항이 포함된 릴리스가 게시될 때까지 패치가 적용된 로컬 설치본이나 `patch-package`를 사용하세요.

Question 2

`check_staleness.py`에서 지원되지 않는 `git diff --since` 오류를 어떻게 수정하나요?

Accepted Answer

`git diff`는 `--since`를 지원하지 않으며, `git log`와 같은 명령어만 지원합니다. `session-handoff/scripts/check_staleness.py`에서 `git diff` 호출의 `--since`를 제거하고, 세 개의 개별 소스에서 변경된 파일을 수집한 다음 병합하여 중복을 제거하세요:

```python
def _git_lines(*args):
    return subprocess.check_output(["git", *args], text=True).splitlines()

tracked_changes = set(_git_lines("diff", "--name-only", "HEAD"))
untracked_files = set(_git_lines("ls-files", "--others", "--exclude-standard"))
committed_changes = set(
    _git_lines("log", f"--since={iso_time}", "--name-only", "--pretty=format:")
)

changed_files = sorted(tracked_changes | untracked_files | committed_changes)
```

`git diff --name-only HEAD`는 스테이징된 변경 사항과 스테이징되지 않은 추적 대상 작업 트리 변경 사항을 포함하고, `git ls-files --others --exclude-standard`는 추적되지 않는 파일을 추가하며, `git log --since=<timestamp>`는 핸드오프 타임스탬프 이후에 이루어진 커밋을 포함합니다.

Question 3

-official 문서 처리 스킬에서 중복되거나 일치하지 않는 스킬 이름은 어떻게 수정하나요?

Accepted Answer

각 `-official` 스킬의 `SKILL.md`를 편집하여 `name` 필드를 해당 디렉터리 이름과 일치하도록 설정하세요. `pptx-official/SKILL.md`를 `name: pptx-official`로, `pdf-official/SKILL.md`를 `name: pdf-official`로, `xlsx-official/SKILL.md`를 `name: xlsx-official`로, 그리고 `docx-official/SKILL.md`를 `name: docx-official`로 업데이트하세요. 이전에는 이러한 변형들이 공식이 아닌 이름(`pptx`, `pdf`, `xlsx`, `docx`)을 잘못 재사용하여 스킬 이름이 중복되었습니다.

Question 4

Claude Code나 다른 AI 에이전트가 git commit --no-verify를 사용하여 git hooks를 우회하지 못하도록 하려면 어떻게 해야 하나요?

Accepted Answer

Bash 명령에 대한 Claude Code `PreToolUse` 훅으로 `block-no-verify` v1.1.2를 사용하세요. 이 훅은 `--no-verify`가 포함된 명령을 가로채서 git 훅이 우회되기 전에 차단합니다.

다음 훅 구성을 추가하세요:

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "npx block-no-verify@1.1.2"
          }
        ]
      }
    ]
  }
}
```

이를 통해 자동화된 에이전트가 `pre-commit`, `commit-msg`, `pre-push`, 린터, 테스트 및 기타 품질 게이트를 몰래 건너뛰는 것을 방지할 수 있습니다.

Question 5

Claude Code Analytics Dashboard에서 'FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory' 오류를 해결하는 방법

Accepted Answer

Claude Code Analytics Dashboard v1.8.2 이상으로 업그레이드하세요. 이번 릴리스에서는 반복적인 데이터 새로 고침 및 file-watcher 업데이트로 인해 발생하던 메모리 누수가 수정되었으며, 업데이트 후에는 메모리 사용량이 안정적으로 유지됩니다. 업그레이드 후 대시보드를 재시작하세요.

임시 해결 방법으로, 시작하기 전에 Node.js 힙 크기를 늘릴 수 있습니다:

NODE_OPTIONS=--max-old-space-size=2048 <your-start-command>

Windows PowerShell의 경우:

$env:NODE_OPTIONS="--max-old-space-size=2048"
<your-start-command>

힙 크기를 늘리는 것은 해당 문제가 있는 버전에서 크래시를 지연시킬 뿐이며, v1.8.2로 업데이트하는 것이 실질적인 해결 방법입니다.

claude-code-templates

개요

README 미리보기

FAQ (5)

同类型项目

hermes-agent

firecrawl

go

markitdown