| name | diagnose-prompts |
| description | 저장소 전체의 prompt, agent instructions, tool configuration, document organization을 종합 점검하여 규칙 불일치·누락·중복을 식별하고 수정 제안을 출력. |
diagnose-prompts
저장소 내 모든 agent 정의, skill 정의, prompt 템플릿, MCP 설정, hook 구성, 공통 규약 문서를 교차 점검하여 불일치를 보고한다.
입력
$ARGUMENTS: (선택) 점검 범위 지정.
all (기본): 전체 점검agents: agent 정의만skills: skill 정의만tools: MCP/tool 설정만docs: 문서 조직만
점검 대상 파일
| 카테고리 | 경로 패턴 |
|---|
| 공통 규약 | AGENTS.md |
| Claude Code agents | .claude/agents/*.md |
| Claude Code commands | .claude/commands/*.md |
| Claude Code settings | .claude/settings.json |
| Claude Code MCP | .mcp.json |
| Copilot shared agents/commands | .claude/agents/*.md, .claude/commands/*.md |
| Copilot instructions | .github/copilot-instructions.md |
| Codex agents | .codex/agents/*.toml |
| Codex config | .codex/config.toml |
| VS Code MCP | .vscode/mcp.json |
| VS Code settings | .vscode/settings.json |
| 공통 skills | .agents/skills/*/SKILL.md |
| Naming conventions | .agents/CONVENTIONS.md |
| References | 문서/*.md |
점검 항목
1. Naming 규칙 일관성
- skill 이름이 verb-noun 규칙을 따르는지 (신규 skill 대상)
- agent 이름이 역할 noun인지
- 채널 간 같은 agent의 이름 대응이 맞는지 (예: Claude
lawyer = Copilot lawyer = Codex lawyer)
2. 채널 간 agent 정의 정합성
각 채널에서 같은 역할의 agent를 비교:
- 역할 설명이 의미적으로 동일한지
- 데이터 조회 우선순위가 일치하는지 (Local → MCP → Web)
- 출력 경로 규칙이 일치하는지
- 금지 사항이 일치하는지
- 스킬 참조가 일치하는지
불일치 발견 시 어느 채널이 기준인지 명시하고 diff를 출력.
3. Skill ↔ Agent 참조 무결성
- agent가 참조하는 skill이
.agents/skills/에 존재하는지
- skill이 참조하는 파일(templates, references)이 존재하는지
- 사용되지 않는 skill이 있는지 (어떤 agent/command에서도 참조 안 됨)
4. Tool/MCP 설정 일관성
.mcp.json, .vscode/mcp.json, .codex/config.toml의 MCP 서버 목록이 동일한지- agent가
legalize-kr/* 도구를 참조하지만 MCP에 해당 서버가 없는 경우
- 환경 변수 의존성이 문서화되어 있는지
5. 문서 조직 일관성
문서/에 있는 참조 자료가 agent/skill에서 실제로 참조되는지- 상호 링크(
[text](path))의 대상 파일이 존재하는지
- AGENTS.md의 규칙이 각 agent/skill에 반영되어 있는지
6. Output 규칙 일관성
- 모든 agent/skill의 출력 경로가 AGENTS.md의 "Output Formats" 섹션과 일치하는지
보관함/결과/ flat 원칙 위반이 없는지- 파일명 규칙 (
<YYYY-MM-DD> <한글>.<ext>)이 준수되는지
출력 형식
## 점검 결과 요약
| 카테고리 | 통과 | 경고 | 오류 |
|---|---|---|---|
| Naming | N | N | N |
| Agent 정합성 | N | N | N |
| Skill 참조 | N | N | N |
| Tool/MCP | N | N | N |
| 문서 조직 | N | N | N |
| Output 규칙 | N | N | N |
## 오류 (즉시 수정 필요)
1. **[카테고리]** 설명 — 파일: 경로, 행: N
- 현재: ...
- 권장: ...
## 경고 (검토 권장)
1. **[카테고리]** 설명 — 파일: 경로
- 현재: ...
- 권장: ...
## 제안 (선택적 개선)
- ...
제약
- 이 스킬은 읽기 전용 진단이다. 파일을 직접 수정하지 않는다.
- AGENTS.md 수정이 필요한 경우 제안 텍스트만 출력한다.
- 점검 결과에서 PII가 포함된 파일 내용을 인용하지 않는다.
- 채널 간 불일치 판정 시 AGENTS.md를 기준(source of truth)으로 삼는다.
