문서

요구사항을 설명하는 방법

새 작업 양식의 모든 필드는 라우팅부터 고급 계획 설정까지 모두 포함합니다.

새 작업새 작업은 Coroid로 작업이 유입되는 주요 방식입니다. 작업 내용을 한 번만 기술하면, 이를 태스크, 단계별 계획, 보고서 또는 반복 일정으로 라우팅할 수 있습니다.

프로젝트 선택기 및 작업 설명 필드 위에 네 가지 라우팅 옵션이 표시된 새 작업 양식입니다.
새 작업: 라우팅, 프로젝트 및 작업 설명

라우팅 – 먼저 결과물을 선택하세요

라우팅은 Coroid가 임의로 결정하는 것이 아니라 사용자가 직접 선택하는 사항입니다. 먼저 결과물을 지정하면, 양식에는 해당 결과물에 적용되는 항목만 표시됩니다.

옵션생성물
실행 가능한 단일 태스크단일 태스크로, 최종적으로 하나의 pull request가 생성됩니다.
단계별 작업 계획코드 작성 전에 승인하는 단계별 계획입니다.
보고서생성된 보고서
일정반복적으로 실행되는 모니터링 작업

선택하기:실행 가능한 단일 태스크작업 내용이 리뷰어가 한 번에 읽을 수 있는 단일 변경사항인 경우에 이 옵션을 선택하세요.단계별 작업 계획여러 변경사항이 특정 순서로 필요하거나, 어떤 작업을 시작하기 전에 전체 접근 방식을 미리 확인하고 싶을 때 이 옵션을 선택하세요.

양식 옆에는 두 가지 바로가기 기능이 있습니다:이슈 가져오기는 추적 시스템에서 작업을 가져오는 기능이며,Coroid에 문의하기동일한 작업을채팅 어시스턴트.

프로젝트

이 작업이 속할 프로젝트를 선택하세요. 사용자는더 많은 프로젝트를 추가할 수 있습니다작업이 여러 관련 프로젝트에 걸쳐 있는 경우에도 이 방식으로 교차 프로젝트 작업을 표현할 수 있습니다.

작업 설명하기

두 개의 필드가 있으며 각각 다른 역할을 합니다.

작업 제목— 짧은 이름입니다. 나중에 목록에서 이 이름으로 작업을 찾을 수 있습니다.

요약— 작업의 핵심 내용: 결과물, 맥락, 제약 조건, 원본 자료 및 Coroid가 제공해야 할 사항입니다. 구현 방법 대신 결과물을 기술하세요; Coroid가 이를테스트 가능한 명세서작업이 이러한 약속 사항과 일치하는지 확인되기 전에 말입니다.

Add rate limiting to the public API.

100 requests per minute per API key. Exceeding it returns 429 with a
Retry-After header. Limits are per key, not per IP.

Internal service-to-service calls are exempt — they authenticate with
service tokens, not API keys.

Do not change the existing auth middleware's public interface.

마지막 줄이 실제로 중요한 역할을 합니다. 범위 정의가 명확한 변경 사항과 광범위한 변경 사항을 구분하는 기준입니다.

고급 설정

선택 사항이며 일반적으로 계획 수립 전에 설정됩니다.

고급 설정이 확장된 화면으로, SDLC 워크플로우 전환 버튼, 목표, AI 프로필, QA 검사 항목, 우선순위, 토큰 예산, 제약 조건 및 브랜치 필드가 나타납니다.
확장된 고급 설정

SDLC 워크플로우 사용하기

기본적으로 비활성화되어 있습니다. 이 기능을 활성화하면의도사양계획 수립 전에 입력해야 합니다. 이를 생략하면 요약 내용을 바탕으로 곧바로 계획이 수립됩니다.

접근 방안이 작성되기 전에 사전 검토 단계가 필요한 중요한 작업일 경우 이 기능을 활성화하세요. 요약 내용이 이미 명확한 작업의 경우에는 비활성화해도 됩니다.

목표

계획이 달성해야 할 결과_이상_요약 내용을 넘어서는 결과입니다. 요청 뒤에 숨겨진 최종 목적을 설정하는 데 사용하세요. 요약 내용은 구현할 대상을 정의하고, 목표는 그 구현의 용도를 명시합니다.

AI 프로필

이 작업에 적용되는 모델은 무엇인가요? 다음을 참조하세요:AI 프로필.

품질 관리 검사

적용될 품질 정책은 무엇인가요? 기본적으로 조직의 품질 관리 정책이 적용되며, 확정된 정책은실행 시작 시 고정됩니다— 이후에 조직 정책이 변경되어도 이미 진행 중인 작업에 소급 적용되지 않습니다.

다음을 참조하세요:품질 정책 및 검증 단계.

우선순위

P0에서P3, 기본값은P2. 대기 중인 작업량이 에이전트 슬롯 수보다 많을 때 우선순위에 따라 대기열이 정렬됩니다. 이는 처리 용량을 늘리는 것이 아니며, 다음을 참조하세요:처리 용량 및 에이전트 슬롯.

생성된 작업당 토큰 제한

각 생성된 작업이 사용할 수 있는 컨텍스트의 상한선입니다. 대규모 코드베이스 전반을 참조해야 하는 작업의 경우 이 값을 높이고, 일상적인 작업에서는 비용을 절감하기 위해 값을 낮추세요.

제약 조건

계획의 제약 조건, 포함하지 않을 항목, 종속성 및 배포 규칙을 설정하세요. 여기에 명시적으로 포함하지 않을 항목을 기재하면 범위 확장을 효과적으로 방지할 수 있습니다.

시작 지점 / 풀 리퀘스트 대상

작업이 시작되는 브랜치와 pull request가 타겟으로 삼는 브랜치를 지정하세요.시작 지점과 동일기본적으로 선택되어 있어 두 설정이 동일하게 적용됩니다.

main → new Coroid branch → PR into main

Coroid는 항상 작업 브랜치를 생성합니다. 이 필드들은 분기 지점과 pull request가 도달할 위치만 변경할 뿐, Coroid가 기존 브랜치에 직접 커밋하도록 설정할 수는 없습니다.

기본 브랜치가 아닌 다른 브랜치, 예컨대develop브랜치나 릴리스 트레인에 병합할 때 이 옵션을 사용하세요.

보조 컨텍스트 추가

선택적 파일과 구조화된 사양을 첨부하세요. 이 작업에 특화된 티켓, 설계 문서, 스택 트레이스를 추가할 수 있습니다.

프로젝트와 관련하여 항상 유효한 자료의 경우, 다음을 사용하세요:프로젝트 컨텍스트매번 다시 첨부하는 대신 모든 작업에 공통으로 적용됩니다.

계획 시작하기

계획 생성 및 수립 시작요약 내용을 바탕으로 계획을 생성하고 즉시 계획 수립을 시작합니다.