dualface/ste-zh

Agent skill: 按 ASD-STE100 (Simplified Technical English) 原则用中文向用户汇报结果

ste‑zh – 중국어 기술 보고 규범 Skill

개요

대규모 언어 모델(LLM) 에이전트(Claude, Cursor, Codex 등)가 통제되고 모호함이 없는 중국어 스타일로 상태 보고서를 작성하도록 지시하는 Agent skill 입니다. 항공 우주 산업 표준 ASD‑STE100(간체 기술 영어)을 중국어(표준 중국어)에 적용하여 '핵심 정보 우선, 증거 기반, 고정 상태' 형식을 강제합니다.

중요성

AI 에이전트는 버그 수정이나 기능 제공 시 장황하고 추측적이거나 불완전한 업데이트를 자주 생성합니다. ste‑zh는 에이전트에게 다음을 강제합니다:
1. 결과를 먼저 진술(예: 已完成…),
2. 구체적인 증거(파일/줄 번호, 테스트 결과) 인용,
3. 완료와 검증을 분리하고,
4. 보류 중인 결정을 번호가 매겨진 옵션으로 제시.
이를 통해 오해가 줄어들고, 인간 검토가 빨라지며, 다중 에이전트 워크플로우(예: 저자의 Kander 보드)를 쉽게 스캔할 수 있습니다.

핵심 기능

핵심 정보 우선 – 첫 문장은 항상 보고서 유형(결과, 진행 상황, 요약 등)을 선언합니다.
고정 상태 어휘 – references/terminology.md에 정의된 제한된 상태 단어 세트(已完成, 已验证, 未验证 등).
증거 기반 – 모든 주장은 검증 가능한 산출물(코드 줄, 테스트 케이스, 명령 출력)로 뒷받침되어야 합니다.
능동태 및 일대일 의미 – 모호한 동사와 애매한 표현을 제거합니다.
결정 옵션 – 인간 입력이 필요할 때, 스킬은 권장 선택지가 포함된 번호 목록을 자동으로 형식화합니다.

설치

권장: Vercel‑Labs skills CLI를 사용하여 정식 이름 ste로 스킬을 등록합니다.

npx skills add dualface/ste-zh -g          # 전역 설치
npx skills add dualface/ste-zh            # 프로젝트 로컬 설치
npx skills add dualface/ste-zh -g -a claude-code  # 특정 에이전트용 설치

수동: 저장소를 에이전트의 skills 디렉토리에 복제하고 폴더 이름을 ste로 지정합니다(예: ~/.claude/skills/ste).

사용 방법

지원되는 에이전트와의 대화에서 트리거 명령 중 하나를 입력합니다:
- /ste
- “用 STE 规范输出”
- “按 ASD‑STE100 汇报”
에이전트는 stop ste(또는 유사한 중지 명령)를 보낼 때까지 후속 답변을 모두 STE‑ZH 규칙에 따라 형식화합니다.
에이전트 출력이 벗어난 경우(예: 긴 컨텍스트 후), 트리거를 다시 보내 스타일을 다시 활성화합니다.

일반적인 워크플로우

에이전트가 작업을 수행(버그 수정, 리팩토링 등).

보고서를 요청 – 에이전트가 STE‑ZH 스타일 블록으로 응답합니다:

已完成：로그인 새로고침 로직의 코드 수정. iOS 쪽은 미검증.

원인: 두 요청이 동시에 토큰을 새로고침하여, 나중에 완료된 새로고침이 먼저 얻은 토큰을 무효화했습니다.

증거:
- auth/refresh.ts:42 — 새로고침 전에 이미 새로고침이 진행 중인지 확인하지 않습니다.
…

결정을 내림 – 옵션 번호(예: 1)로 답장합니다.
에이전트가 선택에 따라 진행.

대상

코드 검토, 디버깅 또는 문서화를 위해 LLM 에이전트를 사용하고 간결하고 검증 가능한 업데이트가 필요한 팀.
Kander와 같은 다중 에이전트 오케스트레이션 도구 사용자로, 보드에 많은 작업이 표시되고 빠른 스캔이 필수적인 경우.
매번 사용자 정의 프롬프트를 작성하지 않고 일관된 중국어 보고 스타일을 원하는 개발자.

라이선스

MIT(LICENSE 참조).

저자의 관련 프로젝트

Kander – 규칙 기반 다중 에이전트 칸반 스케줄러.
Ullage‑cli – Claude, ChatGPT, Grok, Cursor 등의 사용을 추적하는 로컬 데몬/CLI.
QuickTUI – 코딩 에이전트용 모바일 우선 터미널 UI.

위 정보는 모두 저장소의 README에서 직접 가져온 것입니다.