agentpace은(는) 무엇을 하나요?
사용 시점 누군가 소프트웨어 작업에 소요되는 시간을 묻거나, 에이전트가 수행할 작업에 대해 일/주/월 단위의 일정을 언급할 때.
산출물 측정된 P50/P80/P90 범위와 그 중요 경로(critical path), 인간 작업 부분은 별도 줄로, 그리고 언급된 일정이 있으면 옆에 검증되지 않음(unverified)으로 표시합니다.
"이 작업은 얼마나 걸리나요?"라는 질문에 실제 에이전트 실행 데이터에서 측정된 범위로 답하고, 인간 작업 부분은 별도로 명시하세요. 인간 팀 일정을 인용하지 말고, 단일 숫자를 절대 제시하지 마세요.
이 스킬은 자연어 질문에 트리거됩니다. /pace-estimate는 주어진 계획에 대한 명시적 명령어입니다.
도구 확인
agentpace --version을 실행하세요. 실패하면 사용자에게 설치 명령어를 알려주고 중단하세요. 요청 없이 아무것도 설치하지 마세요:
uv tool install agentpace
사용자가 아무것도 설치하기 원하지 않으면, 대신 assets/portable-prompt.md를 사용하세요.
추정
- 사용자가 달리 명시하지 않는 한 에이전트가 구현을 수행한다고 가정하세요. 불명확하고 답변이 달라질 경우, 한 번 질문하세요.
- 작업을 에이전트가 별도의 실행으로 수행할 태스크로 나누세요.
- 각 태스크에
id,kind,risk를 부여하고, 다른 태스크를 기다려야 할 경우depends_on도 지정하세요.agent_cap은 동시에 실행될 에이전트 수로 설정하세요. - 계획을 파일로 작성하고 추정기를 실행하세요.
{
"agent_cap": 3,
"model": "claude-opus-5-5",
"tasks": [
{ "id": "schema", "kind": "feature", "risk": "normal" },
{ "id": "api", "kind": "feature", "risk": "normal", "depends_on": ["schema"] },
{ "id": "review", "kind": "review", "risk": "low", "depends_on": ["api"] }
]
}
agentpace estimate plan.json
종류(kinds): feature, bugfix, refactor, migration, tests, docs, review, other. 위험도(risks): low, normal, high. 마이그레이션과 되돌리기 어려운 작업에는 risk: high를 사용하세요. model은 선택 사항입니다.
인간 일정 재응답
대화에 이미 사용자, 문서 또는 이전 답변에서 비롯된 일/주/월 단위의 일정이 있을 때, 계획을 추정하고 해당 일정을 원래 표현 그대로 그대로 전달하세요:
agentpace estimate plan.json --quoted "3개월"
그러면 출력에 총계 아래에 Quoted: 줄이 추가되어, 해당 일정이 캘린더 시간이며 인용되고 검증되지 않았음을 표시합니다. 그 줄을 출력된 그대로 측정된 범위 옆에 전달하세요. 인용된 일정을 에이전트 시간으로 변환하지 말고, 나누거나 곱하지 말며, 범위와 비교하거나 비율을 제시하지 마세요: 유일한 에이전트 시간은 측정된 범위이며, 인간 작업 부분은 별도 줄에 남아 있습니다. 인용된 일정과 범위의 차이가 무엇인지 말하지 말고, 그것을 인간 작업 부분이라고 부르지 마세요: 그러면 인간 작업 부분을 에이전트 시간에서 유도하게 됩니다. 인용된 일정이 무엇을 세는지도 말하지 마세요: 아무것도 확인하지 않았습니다.
사용자가 나중에 어떤 숫자가 맞았는지 확인하고 싶다면, --record를 추가한 동일한 명령어를 제안하세요. 작업이 완료되면 agentpace score <id> --session <ref>가 두 숫자를 에이전트가 실제로 소요한 시간과 비교합니다.
결과 보고
- 계획 총계를 세션 시계 기준 P50, P80, P90 범위로 먼저 제시하세요. 계획에는 P80을 권장합니다.
- CLI가 출력하는 세션 시계 줄과 인간 작업 부분 줄을 그대로 전달하세요. 첫 번째 줄은 실행 간 간격이 유휴 한도까지 총계에 포함되므로, 사용자의 짧은 대기 시간이 안에 포함된다고 설명합니다. 측정되지 않은 경우, 인간 작업 부분 줄은 리뷰, 테스트, 의사결정 및 에이전트 전환 간 대기 시간에 대한 추가 허용치가 없다고 명시합니다.
agentpace turns로 측정된 경우, 사용자 자신의 로컬 기록에서 인간 전환당 대기 시간을 인용합니다. 어느 쪽이든, 에이전트 시간에서 숫자를 유도하지 말고, 추정된 전환 횟수로 전환당 대기 시간을 곱하지 마세요. 사용자가 자신의 수치를 제공하면, 이를 반복하고 사용자의 것이라고 표시하세요. 사용자가 리뷰 용량(예: "하루에 4 PR")을 명시하면,--review-capacity "<수치>"와 함께 그대로 전달하고,Review capacity:줄을 출력된 그대로 전달하며, 절대 일정으로 바꾸지 마세요. - 중요 경로(critical path)와 유효 병렬성(effective parallelism)을 명명하세요.
- 모든 경고를 그대로 전달하세요. 경고는 특정 셀의 실행 횟수가 너무 적어 해당 범위가 더 넓은 데이터에 의존함을 의미합니다.
- 압박을 받더라도 단일 숫자를 제시하지 마세요. 누군가 계획에 사용할 하나의 수치가 필요하면 P80을 주고 이를 P80이라고 부르세요.
필요 시 명시할 한계
- 시드 데이터는 한 사람의 워크플로우이므로 사용자의 워크플로우와 다를 수 있습니다.
agentpace ingest는 사용자 자신의 실행 데이터를 이 데이터와 통합합니다.--data ~/.agentpace/runs.jsonl은 사용자의 데이터만 사용합니다. Gemini CLI, OpenCode 및 Cline 어댑터는 실험적이며 실제 세션에서 아직 검증되지 않았으므로, 추정이 이들의 행에 의존할 경우 그렇게 말하세요. - 프롬프트를 읽지 않으면 메타데이터로 기능(feature)과 버그 수정(bugfix) 또는 리팩터(refactor)를 구분할 수 없으므로, 해당 종류들은 데이터를 공유할 수 있습니다.
size는--use-size가 전달되지 않으면 무시됩니다. 저장된 크기는 실행 후 측정되기 때문입니다. 사용자가 요청하지 않으면 전달하지 마세요.
추정 작동 방식에 대한 자세한 내용은 references/method.md를 참조하세요.