누가 써도 같은 요구사항 명세서: ASPICE 산출물 품질을 지침과 스킬로 유지하기
ASPICE 산출물은 누가 언제 쓰느냐에 따라 양식과 내용 수준이 달라집니다. Recoble에서는 조직의 작성 지침을 AI 에이전트의 지침과 AI 어시스턴트의 스킬로 등록해 초안을 쓸 때와 점검할 때 같은 기준을 따릅니다.
이 글의 화면은 가상 제품 「사각지대 감시 장치(BSD)」로 만든 예시입니다. 제품, 사람, 시험 기록은 모두 가상 데이터입니다.
산출물 품질은 왜 사람마다 달라질까요?
작성 지침서가 있어도 문서를 쓰는 동안 지침서를 펴 놓고 대조하는 사람은 드뭅니다. 요구사항 명세서 한 종류만 봐도 이런 차이가 생깁니다.
-
식별자 규칙이 섞입니다. 한 문서는
SYS-FRX-001, 다른 문서는SR_01로 적어서 추적표를 만들 때 사람이 하나씩 맞춥니다. -
속성이 빠집니다. 요구사항 문장은 있는데 검증 방법이나 검증 기준이 비어 있으면 시험 담당자가 합격 기준을 쓴 사람에게 되묻습니다.
-
얼마나 구체적으로 쓰는지가 다릅니다. 「빠르게 경고해야 한다」와 「300 ms 안에 경고를 켜야 한다」가 한 문서에 섞여 있습니다.
-
표지 정보가 제각각입니다. 개정 이력의 형식과 참조 표준의 판 표기가 문서마다 다릅니다.
하나씩 보면 사소한 차이입니다. 하지만 ASPICE 심사에서는 이런 항목이 프로세스 준수 여부를 판단하는 근거가 됩니다. 검증 기준이 없는 요구사항은 SYS.2의 요구사항 속성에서, 식별자가 어긋난 요구사항은 양방향 추적성에서 지적을 받습니다. 프로젝트가 두세 개로 늘면 차이도 함께 커집니다.
에이전트 지침과 스킬
Recoble에서는 지침을 AI 에이전트의 지침 칸이나 AI 어시스턴트의 스킬에 적습니다. 에이전트의 지침은 초안을 쓸 때 따르는 규칙이고 스킬은 이미 쓴 글을 점검하거나 다듬을 때 씁니다.
|
AI 에이전트의 지침 |
AI 어시스턴트의 스킬 |
|
|---|---|---|
|
화면의 설명 |
이 에이전트가 실행될 때 따르는 지침 |
이 스킬을 선택하면 요청 앞에 이 지침이 붙음 |
|
쓰는 때 |
산출물 초안을 새로 만들 때 |
쓴 글을 점검하거나 다듬을 때 |
|
적는 내용 |
식별자 규칙, 필수 속성, 문장 규칙, 금지 사항 |
작업 순서와 결과 형식 |
|
함께 정하는 것 |
읽을 범위, 쓰기 권한, 사용할 도구, 참고 자료 파일 |
스페이스 멤버 공개 여부 |
에이전트에는 참고 자료를 파일로 첨부할 수도 있습니다. 작성 지침서나 가이드라인 PDF를 올리면 에이전트가 실행할 때마다 읽고 근거로 삼습니다. 화면 안내에 따르면 파일당 20MB, 최대 10개까지 올릴 수 있습니다.
초안은 에이전트가 지침대로 씁니다
「시스템 요구사항 명세서 초안」이라는 에이전트를 만들고 지침에 다섯 가지 규칙을 적었습니다.
text
작성 규칙
1. 식별자는 기능 SYS-FRX-, 성능 SYS-PXX-, 인터페이스 SYS-IXX- 뒤에 세 자리 번호를 붙인다.
2. 요구사항마다 일곱 칸을 표로 적는다: 식별자, 요구사항명, 설명, 검증 방법, 검증 기준, 우선 순위, 고객 요구사항 ID.
3. 설명은 한 문장에 요구 하나만 적고, 수치와 단위를 적는다.
4. 검증 방법은 Test, Analysis, Review, Inspection 중에서 고른다.
5. 요청에 없는 수치와 고객 요구사항 ID는 지어내지 않고 「확인 필요」로 적는다.
그다음 양식에 대한 말 없이 제품과 범위만 알려 주었습니다.
text
사각지대 감시 시스템(BSD) 요구사항 작성해줘
제품: 사각지대 감시 장치(BSD, 레이더 기반)
범위: 후측방 레이더 좌/우, 차속·방향지시등·기어 입력, 미러 경고등·부저 출력, 자기진단
제외: 카메라·영상 인식, 능동 조향 개입
기능 2건, 성능 1건만 써 줘.
에이전트는 맨 위 그림처럼 일곱 칸짜리 표로 세 건을 썼습니다. 식별자는 SYS-FRX-001, SYS-FRX-002, SYS-PXX-001이었고 검증 방법은 세 건 모두 Test였습니다. 요청에 없던 감지 거리, 응답 시간, 우선 순위, 고객 요구사항 ID에는 값을 지어내지 않고 「확인 필요」라고 적었습니다. 이 빈 값은 작성자가 고객 사양서에서 찾아 채웁니다.
값을 다 채우고 검토를 마친 명세서는 아래와 같은 모습이 됩니다. 문서 종류가 달라도 표지의 표와 장 순서를 통일하면 검토자는 어느 문서에서든 필요한 항목을 바로 찾습니다.
스킬로 하는 점검
초안을 지침대로 써도 사람이 고치는 동안 규칙에서 벗어나는 문장이 생깁니다. 그래서 점검용 스킬을 따로 만들었습니다. 스킬 이름은 「시스템 요구사항 작성 지침 점검」이고, 내용은 작업 순서 여섯 줄과 결과 형식 한 줄입니다.
스킬은 노트에서 글을 고른 뒤 AI 버튼의 스킬 메뉴에서 선택해 씁니다. 여기서는 스킬 화면의 「시험해 보기」로 AI 어시스턴트에 스킬을 연결하고, 일부러 규칙을 어긴 요구사항 두 건과 규칙에 맞는 한 건, 모두 세 건을 보냈습니다. 어시스턴트의 답은 이렇습니다.
|
요구사항 |
다른 점 |
고칠 안 |
|---|---|---|
|
[SR_01] 사각 영역 차량 감지 |
식별자가 형식과 다름. 검증 방법 「확인」은 허용된 방법이 아님. 검증 기준과 고객 요구사항 ID가 빠짐. 「빠르게」는 판정할 수 있는 기준이 아님 |
식별자 형식을 맞추되 번호는 확인 필요. 검증 방법을 허용된 방법 중에서 정하고 빠진 항목을 보완. 수치와 합격 기준은 원문에 없으므로 확인 필요 |
|
[SYS-FRX-002] 경고 출력 |
설명에 경고등 점등, 경고음 출력, 설정 저장이라는 요구가 여러 개 포함됨. 「정상 동작」은 합격과 불합격을 가를 수 있는 기준이 아님 |
요구를 각각 분리하고, 각 요구의 검증 기준을 판정할 수 있게 작성 |
세 번째 요구사항(경고 지연 300 ms)에 대해서는 지침과 다른 점이 없다고 답했습니다. 스킬에 「원문은 고치지 않는다」고 적었으므로 어시스턴트는 지적만 하고 고칠지 말지는 작성자가 정합니다.
지침이 바뀔 때
조직 표준 템플릿은 해마다 조금씩 바뀝니다. 지침서를 개정해도 이미 쓴 문서와 쓰는 사람의 습관은 한동안 예전 기준을 따릅니다.
스킬과 에이전트 지침에는 「스페이스 멤버에게 공개」 설정이 있습니다. 스킬 화면의 설명은 「공개하면 이 스페이스 멤버가 함께 쓰고, 한 곳을 고치면 모두에게 반영됩니다」입니다. 프로세스 담당자가 스킬을 고쳐 저장하면 팀원이 다음에 그 스킬을 쓸 때부터 새 기준을 따르게 됩니다. 저장하면 버전 번호가 올라가고 지침이 바뀐 이력은 화면 아래 「변경 기록」에 남습니다.
사람이 하는 일은 그대로입니다
에이전트와 어시스턴트가 내놓는 것은 초안과 지적 목록까지입니다. 다음 세 가지는 사람이 맡습니다.
-
수치 결정. 300 ms 같은 수치가 타당한지는 고객 사양과 설계 여유를 아는 사람이 판단합니다.
-
검토와 승인. 동료 검토와 승인 기록은 담당자가 남깁니다. 심사에서 보는 것도 이 기록입니다.
-
지침 관리. 지침과 스킬의 내용에 대한 책임은 프로세스 담당자에게 있습니다. 지침에 오류가 있으면 모든 초안에 그 오류가 들어갑니다.
자주 묻는 질문
Q. 템플릿이 있는데 지침과 스킬이 왜 또 필요한가요?
지침과 스킬은 템플릿이라는 빈 양식을 채우는 방법을 정합니다. 템플릿만 쓰면 칸은 통일되지만 칸에 무엇을 얼마나 구체적으로 적는지는 사람마다 달라집니다.
Q. AI가 쓴 산출물을 ASPICE 심사에서 인정하나요?
심사에서는 누가 썼는지보다 산출물의 내용과 근거, 검토·승인 기록을 확인합니다. AI가 만든 결과는 초안으로 다루며 검토와 승인은 담당자가 기록합니다.
Q. 우리 조직의 양식과 식별자 규칙이 달라도 되나요?
됩니다. 지침과 스킬에는 조직 표준의 장 구성, 식별자, 속성을 그대로 적으면 됩니다.
Q. 산출물 내용이 외부 AI로 전송되나요?
AI 기능을 쓰면 요청 내용이 AI 모델로 전송됩니다. 보안 정책상 제약이 있으면 도입 전에 문의해 주세요.
그림의 제품, 사람, 문서번호, 시험 수치는 설명을 위해 만든 가상 데이터입니다. 팀 도입과 사내 시스템 연동은 문의해 주세요. 도입 문의 sales@recoble.com · 02-508-3913 · www.recoble.com