Community생산성 & 협업github.com

aitormf/agent-skills

승인된 기술 계획을 종속성 순서에 따라 작은 작업으로 분할하고, 영향을 받는 파일, 작업별 검증 및 병렬 그룹을 제공합니다. 계획이 있고 누군가 작업을 분해하거나 구현 준비를 요청할 때 사용하세요.

agent-skills란 무엇인가요?

이 기술은 승인된 기술 계획을 실행 가능한 작업 목록으로 변환하여 `implement` 에이전트가 순차적으로 따르고 완료할 수 있도록 합니다. 각 작업은 문서화된 작업 항목(`docs/specs/<YYYYMMDD>-<type>-<name>/`) 아래에 저장되며, `tasks.md` 파일은 상태 표시 없이 체크박스 진행률로 관리됩니다. 작업 분할 시 종속성을 고려하고, 병렬 실행 가능한 작업은 `[P]`로 표시하며, 각 작업에는 영향을 받는 파일과 검증 방법(특정 테스트나 명령어)이 포함됩니다. 이 기술은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, TDD 방식의 경우 테스트를 코드보다 먼저 배치해야 합니다. 마무리 단계에서는 모든 수용 기준과 보안 테스트가 적용되는지 확인하고, 최종 검증 명령어의 성공 여부를 체크합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aitormf/agent-skills/tree/HEAD/skills/plan-to-tasks

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

계획에서 작업으로

계획을 implement 에이전트가 따라가고 완료할 수 있는 실행 가능한 작업 목록으로 변환합니다.

  • 각 작업 항목은 docs/specs/<YYYYMMDD>-<type>-<name>/에 저장됩니다.
  • tasks.md에는 상태가 없습니다. 진행률은 [x] 체크박스로 표시됩니다.

시작하기 전에

  1. 작업 항목을 식별하고 plan.md 및 spec.md를 읽습니다.

  2. 게이트: 계획의 status가 approved가 아니면 중단하고 다음을 질문합니다.

    계획 상태는 <status>입니다. 계속 진행할까요, 먼저 review-spec으로 검토할까요, 아니면 지금 승인하시겠습니까?

    명시적인 답변을 받은 경우에만 계속하십시오. 계획이 없는 작은 변경의 경우 게이트는 스펙에 적용됩니다.

  3. AGENTS.md의 Commands 섹션(스페인어 프로젝트에서는 Comandos)에 있는 검증 명령어를 읽습니다. 명령어가 없으면 직접 질문하거나 마무리 작업에 경고를 남깁니다.

분할 방법

  • 작은 작업: 각 작업은 검토 가능한 변경이며 프로젝트를 정상 상태로 유지합니다.
  • 종속성 순서로 정렬됩니다. 이전 작업과 병렬로 수행할 수 있는 작업은 [P]로 표시합니다.
  • 각 작업은 영향을 받는 파일(알고 있는 경우)과 검증 방법(어떤 테스트 또는 명령어)을 나열합니다.
  • 프로젝트가 TDD(CONTRIBUTING.md 또는 AGENTS.md에 명시됨)로 작업하는 경우, 테스트는 코드보다 먼저 또는 같은 작업에 배치되어야 하며 절대 마지막에 배치되어서는 안 됩니다.
  • 스펙의 모든 수용 기준과 보안 부정 테스트는 최소 하나의 작업으로 다루어져야 합니다. 다루어지지 않은 경우 그 사실을 명시합니다.
  • 마무리 단계는 필수입니다: 테스트와 검증 명령어가 통과한 수용 기준을 포함해야 합니다.
  • 계획에 없는 작업은 추가하지 마십시오. 계획에 빠진 내용이 있으면 질문으로 제기하십시오.

결과

  1. assets/tasks-template.md를 기반으로 tasks.md 초안을 작성합니다.
  2. 초안에 다음을 포함하여 보여줍니다.
    • 작업
    • 병렬 그룹
    • 검증 지점
    • 남은 질문
  3. 최종 승인을 받은 후에만 작성합니다.
  4. 다음 단계 제안: implement 에이전트로 구현합니다.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬