تشغيل أي مهارة في Manus بنقرة واحدة

ابدأ الآن

docs-organize

النجوم٣

التفرعات٠

آخر تحديث٢٢ مايو ٢٠٢٦ في ٠٦:١٨

기존 docs/와 README, 인접 문서를 읽고 재배치·구조화한다. 라우터 docs/README.md를 정비하고 중복·모순·고아 문서를 정리한다. 새 본문을 만들기보다 기존 문서의 정리가 우선이다.

التثبيت

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

تشغيل في Manus

المصدر

HyeonSeok7

HyeonSeok7/claude-pet

فتح مستودع GitHub عرض مستودعات المنشئ

تنزيل

تشغيل في Manus

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

مطوّرو البرمجياتمهن الحاسوب والرياضيات·SOC 15-1252

SKILL.md

readonly

name	docs-organize
description	기존 docs/와 README, 인접 문서를 읽고 재배치·구조화한다. 라우터 docs/README.md를 정비하고 중복·모순·고아 문서를 정리한다. 새 본문을 만들기보다 기존 문서의 정리가 우선이다.
disable-model-invocation	true

docs-organize

이 skill은 이미 있는 문서를 다시 정리하는 데 쓴다. 새 문서를 만드는 것은 보조 작업이고, 본 작업은 분류·재배치·인덱싱이다. 파일 생성/수정 workflow이므로 수동 호출 전용이다.

사용 시점

기존 docs/ 트리에 파일은 많은데 라우팅이 없어서 새 작업자가 어디부터 봐야 할지 모른다.
한 문서가 비대해져서 SSOT가 흐릿하다.
같은 주제가 여러 곳에 흩어져 있다(예: 빌드 명령이 README, AGENTS.md, docs/setup.md에 각각 있음).
하네스 적용 후 docs/README.md를 라우터로 정비해야 한다.
코드는 그대로인데 문서가 시간이 지나 stale 상태다.

사용하지 않는 경우

코드는 있는데 문서가 아예 없다(이 경우는 code-to-docs를 쓴다).
단일 문서의 본문만 다듬으면 된다(직접 편집).
문서가 부족한 게 아니라 설계 결정이 빠져 있다(이 경우는 pdr).

절차

docs/, README, AGENTS.md, CLAUDE.md, .claude/notes/, .codex/notes/ 트리를 스캔한다.
문서별로 다음을 라벨링한다.
- 주제 영역(rules, project-map, build/test, review, design-review, runbook, FAQ, 도메인 지식 등)
- SSOT 여부(이 주제의 1차 출처인지, 다른 문서에서 참조되는지)
- 상태(현행, stale, 중복, 고아)
중복·모순을 식별한다.
- 같은 주제가 두 곳 이상이면 SSOT 한 곳으로 모은다.
- 모순이 있으면 사용자에게 어느 쪽이 맞는지 묻는다.
재배치 계획을 세운다.
- 위치 변경: <기존 경로> → <새 경로> 와 이유
- 통합: <문서 A, B> → <문서 C> 와 이유
- 분할: <문서 A> → <문서 A1, A2> 와 이유
- 삭제: <문서> 와 이유
사용자 승인을 받는다(영향 범위가 크면 변경 전에 한 번 확인).
재배치 실행.
docs/README.md 라우터를 갱신한다.
- 모든 활성 문서 경로와 한 줄 설명
- 주제별 그룹화
- stale/보류 문서는 명시
참조 링크를 수정한다(다른 문서나 코드 주석에서 옛 경로를 가리키는 것).

docs/README.md 라우터 형식

# Docs

이 폴더는 프로젝트 문서의 진입점이다.

## 문서 라우팅

### 작업 기준
- 프로젝트 규칙 → <경로>
- 빌드/테스트 → <경로>
- 리뷰 기준 → <경로>

### 구조 이해
- 프로젝트 맵 → <경로>
- 아키텍처 → <경로>
- 모듈별 문서 → <경로>

### 결정 기록
- 설계 리뷰 → docs/design-reviews/
- ADR/RFC → <경로>
- 하네스 결정 → .claude/notes/harness-decisions.md(생성된 경우)

### skill / MCP
- skill 추천 결과 → docs/skill-recommendations.md(생성된 경우)
- Context7 MCP → .claude/notes/context7-mcp.md

## 운영 원칙
- 같은 주제는 한 문서에 모은다.
- 새 문서를 만들기 전에 기존 문서에 추가할 자리가 있는지 본다.
- stale/보류 문서는 라우터에서 명시한다.

self-check

같은 주제가 두 곳 이상에 본문으로 남아 있지 않은가
docs/README.md만 보고도 새 작업자가 필요한 문서를 30초 안에 찾을 수 있는가
옛 경로를 가리키는 stale 참조가 없는가
SSOT가 깨끗하고, 모순이 있을 때 어느 쪽이 맞는지 명시했는가
임의로 본문을 통째 복제하지 않았는가

출력 형식

## docs-organize 결과

- 스캔 대상: <트리 요약>
- 라벨링 요약: <주제별 문서 수, SSOT 분포>
- 재배치: <변경 목록>
- 통합/분할/삭제: <목록과 이유>
- 라우터 갱신: docs/README.md
- 옛 참조 수정: <대상 파일과 라인>
- 확인 필요: <사용자 질문 또는 미검증 항목>

المزيد من هذا المستودع

نفس المستودع

ask

HyeonSeok7/claude-pet

사용자 요청이 모호하거나 작업 전 결정이 필요할 때, 바로 구현하지 않고 파일 수정 없이 scope, 대상, 검증 기준을 1-3개 질문으로 좁혀 묻는다.

2026-05-223

code-to-docs

HyeonSeok7/claude-pet

코드를 읽고 docs/를 생성·구조화한다. 코드만 있고 문서가 없는 영역에서 프로젝트 맵, 모듈 문서, API 개요, 아키텍처 메모를 만든다.

2026-05-223

handoff

HyeonSeok7/claude-pet

작업 결과, 수정 파일, 검증 내역, 남은 리스크, 그리고 사용자가 바로 고를 수 있는 다음 액션 후보를 짧게 정리해 인수인계한다.

2026-05-223

pdr

HyeonSeok7/claude-pet

Product Design Review — 신규 기능/화면/API/모듈을 만들거나 크게 바꾸기 전에 목표·사용자 시나리오·제약·엣지케이스·검증 기준을 짧게 결정해 docs/design-reviews/에 남긴다.

2026-05-223

release-check

HyeonSeok7/claude-pet

claude-pet 릴리스/배포 전 점검 — gradle.properties 버전 정합성, 3단 빌드 검증(compile → 개발 실행 → 번들), README/docs 동기화, release-please 상태를 확인한다. 트리거 — '릴리스 점검', '배포 전 확인', 'release-check', '릴리스 준비됐는지 봐줘'.

2026-05-223

skill-craft

HyeonSeok7/claude-pet

프로젝트 스택과 반복 작업을 분석해 custom skill을 실제로 생성한다. 후보 기록만으로 끝나지 않고 .claude/skills/<name>/SKILL.md를 만든다.

2026-05-223

docs-organize

사용 시점

기존 docs/ 트리에 파일은 많은데 라우팅이 없어서 새 작업자가 어디부터 봐야 할지 모른다.

한 문서가 비대해져서 SSOT가 흐릿하다.

같은 주제가 여러 곳에 흩어져 있다(예: 빌드 명령이 README, AGENTS.md, docs/setup.md에 각각 있음).

하네스 적용 후 docs/README.md를 라우터로 정비해야 한다.

코드는 그대로인데 문서가 시간이 지나 stale 상태다.

사용하지 않는 경우

코드는 있는데 문서가 아예 없다(이 경우는 code-to-docs를 쓴다).

단일 문서의 본문만 다듬으면 된다(직접 편집).

문서가 부족한 게 아니라 설계 결정이 빠져 있다(이 경우는 pdr).

절차

docs/, README, AGENTS.md, CLAUDE.md, .claude/notes/, .codex/notes/ 트리를 스캔한다.

문서별로 다음을 라벨링한다.

주제 영역(rules, project-map, build/test, review, design-review, runbook, FAQ, 도메인 지식 등)
SSOT 여부(이 주제의 1차 출처인지, 다른 문서에서 참조되는지)
상태(현행, stale, 중복, 고아)

중복·모순을 식별한다.

같은 주제가 두 곳 이상이면 SSOT 한 곳으로 모은다.
모순이 있으면 사용자에게 어느 쪽이 맞는지 묻는다.

재배치 계획을 세운다.

위치 변경: <기존 경로> → <새 경로> 와 이유
통합: <문서 A, B> → <문서 C> 와 이유
분할: <문서 A> → <문서 A1, A2> 와 이유
삭제: <문서> 와 이유

사용자 승인을 받는다(영향 범위가 크면 변경 전에 한 번 확인).

재배치 실행.

docs/README.md 라우터를 갱신한다.

모든 활성 문서 경로와 한 줄 설명
주제별 그룹화
stale/보류 문서는 명시

참조 링크를 수정한다(다른 문서나 코드 주석에서 옛 경로를 가리키는 것).

docs/README.md 라우터 형식

# Docs 이 폴더는 프로젝트 문서의 진입점이다. ## 문서 라우팅 ### 작업 기준 - 프로젝트 규칙 → <경로> - 빌드/테스트 → <경로> - 리뷰 기준 → <경로> ### 구조 이해 - 프로젝트 맵 → <경로> - 아키텍처 → <경로> - 모듈별 문서 → <경로> ### 결정 기록 - 설계 리뷰 → docs/design-reviews/ - ADR/RFC → <경로> - 하네스 결정 → .claude/notes/harness-decisions.md(생성된 경우) ### skill / MCP - skill 추천 결과 → docs/skill-recommendations.md(생성된 경우) - Context7 MCP → .claude/notes/context7-mcp.md ## 운영 원칙 - 같은 주제는 한 문서에 모은다. - 새 문서를 만들기 전에 기존 문서에 추가할 자리가 있는지 본다. - stale/보류 문서는 라우터에서 명시한다.

self-check

같은 주제가 두 곳 이상에 본문으로 남아 있지 않은가

docs/README.md만 보고도 새 작업자가 필요한 문서를 30초 안에 찾을 수 있는가

옛 경로를 가리키는 stale 참조가 없는가

SSOT가 깨끗하고, 모순이 있을 때 어느 쪽이 맞는지 명시했는가

임의로 본문을 통째 복제하지 않았는가

출력 형식

## docs-organize 결과 - 스캔 대상: <트리 요약> - 라벨링 요약: <주제별 문서 수, SSOT 분포> - 재배치: <변경 목록> - 통합/분할/삭제: <목록과 이유> - 라우터 갱신: docs/README.md - 옛 참조 수정: <대상 파일과 라인> - 확인 필요: <사용자 질문 또는 미검증 항목>