Azure DevOps Boards: 내 카드
Azure Boards에서 카드를 관리하는 한 사람을 MCP 또는 az를 통해 지원합니다. 팀 관례는 config에 저장되며, 동일한 스킬이 여러 팀에 맞춰 사용될 수 있습니다.
1. 가장 먼저 할 일
- 설정 읽기 —
~/.config/ado-boards/config.md(Windows:%USERPROFILE%\.config\ado-boards\config.md). 파일이 없으면 → 핵심 설정(workflows/setup.md)부터 실행합니다. 조직/프로젝트를 추측하면 잘못된 위치에 기록될 수 있습니다.not set yet으로 표시된 값은 첫 번째 워크플로우에서 필요할 때 수집됩니다. - 이번 턴에서 사용할 백엔드 선택
- MCP: Azure DevOps MCP 도구를 사용할 수 있을 때(예:
wit_work_item):mcp-tools.md를 로드합니다(해당 맵에 MCP 갭이 문서화된 경우az/갭 파일 하나만 추가). - az: 그 외의 경우:
az/README.md와 이 워크플로우에 해당하는 섹션 파일 하나를 로드합니다. HTML 설명/수락 기준 작성이 깨지거나 PowerShell 인용이 실패할 때만az/windows.md도 로드합니다. 로그인 확인(az account show또는AZURE_DEVOPS_EXT_PAT) 수행하고, 둘 다 없으면 사용자가 직접az login을 실행합니다. - 둘 다 아님 → 설정 안내로 안내합니다.
- MCP: Azure DevOps MCP 도구를 사용할 수 있을 때(예:
- 해당 워크플로우 열기 (아래 표 참조) 및 따라 수행. 워크플로우는 무엇을 할지 알려주고, 백엔드 파일은 어떻게 할지 알려줍니다. §2의 규칙은 두 백엔드에 모두 적용됩니다.
설정이 준비되고, 하나의 백엔드가 선택되고, 워크플로우 파일이 열리면 준비 완료입니다.
사용자는 직접 로그인합니다(Entra / az login). 자격 증명은 채팅 밖에 유지됩니다.
2. 규칙
읽기는 권한이 필요 없습니다. 모든 쓰기 작업은 미리보기와 명시적인 동의가 필요합니다. — 도구 자체에서 묻지 않더라도 마찬가지입니다. 보드는 공유되며, MCP 쓰기는 종종 프롬프트를 건너뛰므로 미리보기가 게이트 역할을 합니다.
| 규칙 | 기준 |
|---|---|
| 미리보기 크기 | 사용자 자신의 카드에 대한 한 가지 변경 → 한 줄 (#512: State Active -> Closed. OK?). 여러 변경 사항 또는 다른 사람의 카드 → 표 (ID, 필드, 이전 값, 새 값). 10개 초과 → 개수를 알리고 다시 확인. |
| 읽기-쓰기 피드백 | 모든 쓰기 후: ID, 변경 내용, URL https://dev.azure.com/<org>/<project>/_workitems/edit/<id> 보고. |
| 부모 | 설정에서 Parent required: yes인 경우: 부모와 함께만 생성 (부모 없는 카드는 백로그 보기에서 사라짐). |
| 버그 | 설정에서 버그가 다른 곳에 있다고 지정한 경우: 기존 버그 아래 Task 생성 (두 번째 Bug는 이력을 분할함). |
| 외부 카드 | 설정의 제목 접두사(예: EXT): 댓글 또는 필드 변경 전에 댓글이 보고자에게 동기화될 수 있음을 경고. 닫을 때 Impact 건너뛰기. |
| 단위 | 시간 필드는 일반 숫자이며, 단위는 설정에 있음. 사용자가 다른 단위를 말하면 변환하고, 둘 다 표시하며, 항상 단위를 명명(Boards UI는 어느 쪽이든 "h"라고 표시). |
| 카드는 유지 | 닫거나 이동하고, 카드를 보드에 남겨둠. 댓글을 삭제하기 전에는 전체 내용을 보여주고 동의를 받아야 함 — 둘 다 되돌릴 수 없음. |
| 자신의 댓글만 | 자신의 댓글만 편집/삭제 (ADO는 나머지를 거부함). |
| 실제 값 | 추정치, 담당자, 날짜, 영향 등을 묻거나 비워둠. 허구의 숫자는 보드에 실제처럼 보임. |
| 안전한 인용 | 값은 안전하게 인용하며, 제목에는 따옴표가 포함될 수 있음. |
| 쓰기 푸터 | 쓰기 후: 수행한 작업, 건너뛴 작업, 다음 단계 하나. 일반 읽기: 답변만. |
3. 워크플로우
| 상황 | 열기 |
|---|---|
| ADO 스킬 설정; 설정 누락; 무언가 변경됨 | workflows/setup.md |
| 내 할 일 확인; 내 카드 보기; 이동; 시간 기록; 닫기 | workflows/my-cards.md |
| 카드 생성; 스토리를 작업으로 분할 | workflows/create-card.md |
| 댓글 추가, 나열, 편집, 삭제 | workflows/comments.md |
| 설명 또는 수락 기준 | workflows/write-description.md |
| 내 스프린트 계획; 무엇을 먼저 작업할지 | workflows/plan-my-sprint.md |
4. Agile 참조 (설정과 대조하여 확인)
계층 구조: Epic > Feature > User Story > Task. Bug는 팀 설정에 따라 Story 옆 또는 아래에 위치.
| 유형 | 상태 |
|---|---|
| Feature / User Story | New, Active, Resolved, Closed, Removed |
| Bug | New, Active, Resolved, Closed |
| Task | New, Active, Closed, Removed |
부모: Task는 User Story(또는 Bug) 아래, User Story는 Feature 아래. 사용자 정의 상태와 필수 필드는 수집 후 설정에 저장됩니다.