harness-diagnostics
코드베이스와 Codex skill의 에이전트 친화도(harness)를 12개 원칙으로 진단하고 개선안을 제안합니다. 사용 상황: 신규 환경 구축(Setup), 현 상태 점검(Audit), drift 정리(Maintenance), skill 품질 검사(Self).
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
코드베이스와 Codex skill의 에이전트 친화도(harness)를 12개 원칙으로 진단하고 개선안을 제안합니다. 사용 상황: 신규 환경 구축(Setup), 현 상태 점검(Audit), drift 정리(Maintenance), skill 품질 검사(Self).
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
코드베이스와 Codex skill의 에이전트 친화도(harness)를 12개 원칙으로 진단하고 개선안을 제안합니다. 사용 상황: 신규 환경 구축(Setup), 현 상태 점검(Audit), drift 정리(Maintenance), skill 품질 검사(Self).
티스토리 기술 블로그 글쓰기 도우미. 한국어 기술 문서 작성과 티스토리 플랫폼 최적화를 지원합니다. 이 스킬은 다음 상황에서 사용하세요: - 기술 블로그 글 구조를 잡고 싶을 때 - 코드 설명 글을 작성할 때 - 한국어 기술 문서 작성 시 표현 교정이 필요할 때 - 티스토리에 최적화된 마크다운/HTML 형식이 필요할 때 - TIL, 튜토리얼, 트러블슈팅, 딥다이브 글을 작성할 때 - SEO 최적화 (제목, 설명, 태그)가 필요할 때
CTO 수준의 프론트엔드 과제 평가용 Codex skill. 채용 과제를 체계적으로 분석하고 객관적인 평가 리포트를 생성합니다. 사용 상황: - 프론트엔드 채용 과제를 평가할 때 - 코드 품질, 아키텍처, 테스트 전략을 분석할 때 - 제한시간(2일/7일)에 따른 기대치 조정이 필요할 때 - 객관적인 채용 판단 근거가 필요할 때 - 지원자에게 피드백을 제공할 때
CTO 수준의 프론트엔드 과제 평가 도우미. 채용 과제를 체계적으로 분석하고 객관적인 평가 리포트를 생성합니다. 이 스킬은 다음 상황에서 사용하세요: - 프론트엔드 채용 과제를 평가할 때 - 코드 품질, 아키텍처, 테스트 전략을 분석할 때 - 제한시간(2일/7일)에 따른 기대치 조정이 필요할 때 - 객관적인 채용 판단 근거가 필요할 때 - 지원자에게 피드백을 제공할 때
| name | harness-diagnostics |
| description | 코드베이스와 Codex skill의 에이전트 친화도(harness)를 12개 원칙으로 진단하고 개선안을 제안합니다. 사용 상황: 신규 환경 구축(Setup), 현 상태 점검(Audit), drift 정리(Maintenance), skill 품질 검사(Self). |
| version | 1.4.0 |
에이전트 협업 환경의 성숙도를 평가하고 실행 가능한 리포트를 생성합니다.
| 모드 | 트리거 | 목적 | 워크플로우 |
|---|---|---|---|
| Setup | 새 프로젝트, "환경 구축" | 초기 harness 구성 제안 | references/setup-workflow.md |
| Audit | "진단", "점검" | 점수화 + 개선 로드맵 | references/audit-workflow.md |
| Maintenance | "drift", "정리" | 변경 감지 + GC 제안 | references/maintenance-workflow.md |
모드가 애매하면 사용자에게 확인한다.
초기 프로젝트에서 이 skill을 사용할 때는 다음 순서를 권장한다.
AGENTS.md, docs/, lint/test/CI, 구조 규칙을 먼저 정리예:
npx create-next-app@latest ... 이후 Setup 실행uv init 또는 poetry new 이후 Setup 실행go mod init 이후 Setup 실행중요:
| 대상 | 판별 기준 | 체크리스트 |
|---|---|---|
| 코드베이스 | git repo + 소스 존재 | references/codebase-checklist.md |
| Skill | .codex/skills/*/SKILL.md | references/skill-checklist.md |
| Self | 본 skill 자체 | references/skill-checklist.md |
references/principles.md를 기준으로 P1~P12를 0-10점으로 평가한다.
P1 Agent Entry Point, P2 Map, P3 Invariant, P4 Convention, P5 Progressive Disclosure,
P6 Layered, P7 Garbage Collection, P8 Observability, P9 Knowledge, P10 Reproducibility, P11 Modularity, P12 Self-Documentation.
| 등급 | 점수 | 의미 |
|---|---|---|
| L1 | 0-19 | None |
| L2 | 20-39 | Basic |
| L3 | 40-59 | Structured |
| L4 | 60-79 | Optimized |
| L5 | 80-100 | Autonomous |
가중치/산식은 references/maturity-framework.md를 따른다.
references/report-template.md 형식으로 리포트 출력scripts/self-audit.shscripts/update-self-meta.shscripts/calculate-score.jsreferences/score-template.mdreferences/score-template.jsonlogs/self-audit-log.md| 파일 | 역할 |
|---|---|
references/principles.md | 12원칙 판단 기준 |
references/maturity-framework.md | 차원/가중치/점수 산식 |
references/codebase-checklist.md | 코드베이스 체크리스트 (84항목) |
references/skill-checklist.md | Skill 체크리스트 (40항목) |
references/setup-workflow.md | Setup 워크플로우 |
references/audit-workflow.md | Audit 워크플로우 |
references/maintenance-workflow.md | Maintenance 워크플로우 |
references/report-template.md | 리포트 출력 형식 |
references/score-template.md | 차원/종합 점수 계산 표 |
references/score-template.json | 자동 계산 입력 스키마 |
| 파일 | 내용 |
|---|---|
examples/sample-agents-md.md | AGENTS.md 예시 |
examples/sample-setup-report.md | Setup 리포트 예시 |
examples/sample-report.md | Audit 리포트 예시 |
examples/sample-docs-structure.md | 권장 docs 구조 |