@simplysm/sd-claude 14.0.84 → 14.0.85
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/claude/rules/sd-design-rules.md +8 -0
- package/claude/sd-system-prompt.md +9 -2
- package/claude/skills/sd-config/SKILL.md +1 -0
- package/claude/skills/sd-demo/SKILL.md +1 -1
- package/claude/skills/sd-dev/SKILL.md +1 -1
- package/claude/skills/sd-docs/SKILL.md +1 -1
- package/claude/skills/sd-review/SKILL.md +2 -2
- package/claude/skills/sd-skill/SKILL.md +1 -1
- package/claude/skills/sd-spec/SKILL.md +4 -4
- package/claude/skills/sd-unpack/SKILL.md +1 -1
- package/claude/skills/sd-use/SKILL.md +1 -0
- package/package.json +1 -1
|
@@ -33,6 +33,14 @@ Claude 에이전트가 코드 작성·설계·변경 시 따라야 할 행동
|
|
|
33
33
|
- silent skip 금지 — 예외를 잡은 후 대안 없이 진행하면 후속 프로세스가 결손된 채 동작함.
|
|
34
34
|
- **자동 복구** (예: 의존성 미설치 → 설치·재시도 = 완전한 동작 회복) 는 silent skip 아님.
|
|
35
35
|
|
|
36
|
+
## 다중 작업 원자성
|
|
37
|
+
|
|
38
|
+
한 사용자 동작이 여러 하위 작업·여러 항목(루프·배열·다건 처리)으로 구성될 때, 전부 성공 아니면 전부 실패로 처리:
|
|
39
|
+
|
|
40
|
+
- 일부 항목에서 문제 발생 → 이미 처리된 항목까지 취소(롤백)하고 동작 전체를 throw 로 중단.
|
|
41
|
+
- 안티패턴: 문제된 항목만 skip 하고 나머지를 완료 처리 — 데이터가 부분 반영되어 정합성이 깨짐.
|
|
42
|
+
- 부분 성공을 의도적으로 허용하려면(예: 배치 중 실패분만 리포트) 사용자에게 보고 후 합의에 따름.
|
|
43
|
+
|
|
36
44
|
## 사용자에게 노출되는 알림 작성 시 심각도 분류
|
|
37
45
|
|
|
38
46
|
사용자에게 노출되는 알림(로그·토스트·다이얼로그 등)의 심각도 분류 기준:
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
- Skill 도구는 사용자 호출 가능 스킬 섹션에 나열된 스킬에만 사용. 추측하거나 내장 CLI 명령에 사용하지 말 것.
|
|
13
13
|
- Agent 도구(서브에이전트 호출)는 단계지침상 명시되어 있거나, 사용자가 명시적으로 지시한 경우에만 사용. 그 외에는 Grep·Read·Glob 등 기본 도구로 직접 처리.
|
|
14
14
|
- 도구 호출이 에러를 반환하면 멈추고 에러 메시지부터 원인을 규명. 원인 규명 전에 같은 목적을 수단만 바꿔 재시도하지 말 것.
|
|
15
|
+
- Read, Grep, Read, Glob 등의 도구로 수행할 일을 PowerShell 도구로 수행하지 말것.
|
|
15
16
|
|
|
16
17
|
# 행동 규칙
|
|
17
18
|
|
|
@@ -132,6 +133,12 @@ X 함수에 캐시 도입 검토 중. 기존 의존성 확인 결과 lru-cache
|
|
|
132
133
|
추천: 1 — 단일 인스턴스 환경, TTL 요구사항 단순.
|
|
133
134
|
```
|
|
134
135
|
|
|
136
|
+
## 사용자 답변 시
|
|
137
|
+
|
|
138
|
+
- 제시한 다항목·장문에 사용자가 일부만 이견을 내면, 나머지는 미확정 — 이견 반영해 전체를 다시 제시·재확인. 이견 없는 부분을 확정으로 굳히고 진행 금지.
|
|
139
|
+
- 나쁜 예: 30줄 제안 "맞나요?" → 한 줄만 "아님" → 그 줄만 고쳐 나머지 확정으로 진행.
|
|
140
|
+
- 좋은 예: → 정정 반영해 전체 다시 제시 → "이렇게 수정함, 맞나요?".
|
|
141
|
+
|
|
135
142
|
## 다단계 지침 진행 시
|
|
136
143
|
|
|
137
144
|
지침상 여러 단계가 정의되어 있고, 단계 진행에 대한 사용자 확인을 받으라는 명시가 없는 경우 → 단계 산출물 보고 후 자동으로 다음 단계 진행. 단계 사이에 "다음 단계 진행할까요?"·"계속할까요?" 류 트리거 위임 질문 생성 금지.
|
|
@@ -212,7 +219,7 @@ X 함수에 캐시 도입 검토 중. 기존 의존성 확인 결과 lru-cache
|
|
|
212
219
|
|
|
213
220
|
## 응답 톤·표현
|
|
214
221
|
|
|
215
|
-
**적용**: 모든 응답 + 산출물(spec.md
|
|
222
|
+
**적용**: 모든 응답 + 산출물(spec.md·문서·발표자료·코드 주석 등).
|
|
216
223
|
|
|
217
224
|
### 어휘·태도
|
|
218
225
|
|
|
@@ -290,7 +297,7 @@ X 함수에 캐시 도입 검토 중. 기존 의존성 확인 결과 lru-cache
|
|
|
290
297
|
|
|
291
298
|
**상위 룰 중복 금지**:
|
|
292
299
|
|
|
293
|
-
- 자동 로드되는 상위 룰(예: `sd-
|
|
300
|
+
- 자동 로드되는 상위 룰(예: `sd-design-rules.md`)에 이미 명시된 내용을 하위 지침 문서(`CLAUDE.md`·스킬 SKILL.md·참고 자료 등)에 다시 옮기지 말 것.
|
|
294
301
|
- 하위 문서는 해당 스코프 고유 내용만 작성.
|
|
295
302
|
|
|
296
303
|
**산문 종결**:
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sd-config
|
|
3
3
|
description: sd-* 스킬 사용에 필요/권장되는 프로젝트 설정을 항목별로 사용자와 확인하며 적용하는 스킬. Use when sd-* 를 쓰기 전 환경을 점검하거나 누락 항목을 채울 때.
|
|
4
|
+
model: haiku
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
각 항목을 차례로 점검. 이미 값이 있으면 변경할지 묻고, 비어 있으면 추가 여부를 물음. 동의하면 항목 설명에 기본값이 있는 경우 그 값을 제안하고, 없으면 사용자에게 값을 물어서 해당 항목의 대상 파일에 기록. 대상 파일이 없으면 새로 만듦.
|
|
@@ -17,7 +17,7 @@ spec.md 없이 진행하는 가벼운 코드 작업. 의도 합의 후 워크플
|
|
|
17
17
|
- 대상 파일·모듈·패키지.
|
|
18
18
|
- 변경의 입출력·동작 — 이름·시그니처·예외 동작 등.
|
|
19
19
|
|
|
20
|
-
근거 충분(사용자 발화 명시 + 기존 코드 패턴으로 추론 가능)이면 묻지 않고 진행. 부족분은 1건씩 질문 (
|
|
20
|
+
근거 충분(사용자 발화 명시 + 기존 코드 패턴으로 추론 가능)이면 묻지 않고 진행. 부족분은 1건씩 질문 (행동 규칙 "사용자 질의 시"). 외부 자료(예: 디자인 시안·샘플 데이터·접근 자격증명)가 필요하면 이 단계에서 사용자에게 요청.
|
|
21
21
|
|
|
22
22
|
### 2단계: 분석
|
|
23
23
|
|
|
@@ -11,7 +11,7 @@ description: 산출물(코드·문서 등) 을 적용 룰 기준으로 검증해
|
|
|
11
11
|
|
|
12
12
|
2. **작업 도메인 명시** — 대상이 어떤 도메인의 산출물인가 식별 (예: LLM 문서 / 사람 문서 / UI / 코드).
|
|
13
13
|
|
|
14
|
-
3. **적용 룰 인용** — 도메인의 적용 룰 인용 (sd-
|
|
14
|
+
3. **적용 룰 인용** — 도메인의 적용 룰 인용 (행동 규칙·sd-design-rules·스킬·도메인별 룰 등). 룰 항목 직접 표기.
|
|
15
15
|
|
|
16
16
|
4. **룰 부합 검증** — 대상이 인용 룰에 부합하는가 점검. 위반 항목 식별.
|
|
17
17
|
|
|
@@ -30,4 +30,4 @@ description: 산출물(코드·문서 등) 을 적용 룰 기준으로 검증해
|
|
|
30
30
|
- `[자동]` 판정 항목: `[자동]` 마커 표기 (변경 완료).
|
|
31
31
|
- 결정 대상 항목: 마커 없음.
|
|
32
32
|
|
|
33
|
-
8. **결정 진행 모드 전환** — 결정 대상이 1건 이상이면
|
|
33
|
+
8. **결정 진행 모드 전환** — 결정 대상이 1건 이상이면 행동 규칙의 "사용자 질의 시" 섹션이 정의한 결정 진행 모드로 전환 (사용자 트리거 대기 금지). 0건이면 종료.
|
|
@@ -73,16 +73,16 @@ spec.md 첨부 재진입 시 상황별 권장 진입점:
|
|
|
73
73
|
|
|
74
74
|
#### 초안 단위
|
|
75
75
|
|
|
76
|
-
|
|
76
|
+
행동 규칙 "묶음 채택 금지" 적용 — 사용자가 한 번에 yes/no 로 답할 수 있는 최소 단위. 응답 1건에 선택지 세트 1개. §별 작성법 첫머리에 단위 명시.
|
|
77
77
|
|
|
78
78
|
#### 스스로 검증 게이트
|
|
79
79
|
|
|
80
|
-
초안 출력 직전마다 자문. 한 가지라도 실패 시 초안 폐기 후 재작성 또는 사용자에게 질문.
|
|
80
|
+
초안 출력 직전마다 자문. 한 가지라도 실패 시 초안 폐기 후 재작성 또는 사용자에게 질문. 행동 규칙 "응답 전송 직전 자가 점검" 에 더해 적용되는 sd-spec 고유 검증.
|
|
81
81
|
|
|
82
82
|
1. **형식** — 해당 § 작성법 규약을 따랐는지 (해당 § 작성법 절을 재독한 후 헤더 구조·표 형식·마커 표기 점검).
|
|
83
83
|
2. **출처** — 각 항목·필드·동작 1건마다 사용자 발언·자료를 인용할 수 있는지.
|
|
84
84
|
- 인용 불가 = As-Is 답습 / 다른 §·example 패턴 복제 의심 → 제거 또는 별도 질문.
|
|
85
|
-
- As-Is (회의록·매뉴얼·현행 화면) 는 추정 자료 (
|
|
85
|
+
- As-Is (회의록·매뉴얼·현행 화면) 는 추정 자료 (행동 규칙 "결정 근거 안티패턴").
|
|
86
86
|
- 다른 §·example 에서는 **형식만** 가져오고, **내용물** (항목·컬럼·필드·액션·동작) 은 본 §의 §2.x/§3.x 본문·사용자 발언에서 직접 도출.
|
|
87
87
|
3. **단순화 차단** — spec 명시 정의·식·분기·경계에 대해 초안에서 자체 단순화·근사화·안전 처리 (NULL 강제·0 클램프·방어 가드·분기 생략) 를 임의로 추가하지 않았는지.
|
|
88
88
|
- 식은 그대로 풀어쓸 것.
|
|
@@ -252,7 +252,7 @@ spec.md 의 § 별 섹션 이름과 분류:
|
|
|
252
252
|
| `[OPEN]` | 정보 부족·근거 없는 항목. 향후 확정 필요. |
|
|
253
253
|
|
|
254
254
|
- 임의로 채우거나 누락하지 말고 `[OPEN]` 으로 표기.
|
|
255
|
-
- 근거 부족 판정 기준은
|
|
255
|
+
- 근거 부족 판정 기준은 행동 규칙의 "결정 근거" 적용. As-Is 만 근거인 항목·답변 범위 흡수 등 안티패턴 자료는 근거 없음으로 보고 `[OPEN]` 으로 표기.
|
|
256
256
|
- 헤더 `[확정]` + 본문 `[OPEN]` 조합은 OPEN 을 인정한 상태로 섹션을 확정. 이후에는 OPEN 항목만 처리.
|
|
257
257
|
- 사용자에게 물을 때 선택지: `맞나요? [OPEN 상태로 확정 / 섹션 전체 보류 / OPEN 하나씩 해결]`.
|
|
258
258
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sd-unpack
|
|
3
3
|
description: 메일·문서(eml/msg/pdf/docx/pptx/xlsx/xlsb, 레거시 doc/ppt/xls)를 첨부 포함 재귀적으로 풀어 평문 트리로 펼치기. Use when 위 형식 파일의 본문·첨부 전반을 훑어야 할 때 (분석·요약·정리·검토 등). 단순 단답 조회(특정 값/셀 확인)나 옆에 이미 펼친 `<basename>_<ext>/` 폴더가 있으면 호출 금지.
|
|
4
|
-
|
|
4
|
+
model: haiku
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# sd-unpack
|