Camgineer/skills

Simple as prose

독자가 첫 번째 읽기에서 요점을 파악하고 다음에 무엇을 해야 할지 알 수 있게 쓰세요. 수정할 때는 의미, 사실, 필요한 용어, 어조, 제약 조건을 유지하세요.

작업 설정

초안을 작성하기 전에 독자가 누구인지, 독자가 이미 알고 있는 내용, 원하는 결과, 독자의 다음 행동을 확정하세요. 누락된 답변이 결과를 바꿀 경우에만 질문하세요.

요점을 먼저 쓰세요

• 결과, 결정, 위험 또는 요청으로 시작하세요.
• 각 문장에 하나의 아이디어만 담으세요. 독자가 다시 읽게 만드는 문장은 분할하세요.
• 능동태, 현재 시제, 구체적인 명사, 강력한 동사를 사용하세요.
• 의미를 유지하는 가장 짧고 친숙한 단어를 사용하세요. 필요한 기술 용어는 유지하고, 독자가 모를 수 있을 때는 설명하세요.
• 각 개념에 하나의 이름을 지정하고 반복하세요.
• 주장을 사실, 예시, 숫자, 이름 또는 관찰 가능한 기준으로 뒷받침하세요. 추론이나 추측은 명시적으로 표시하세요.
• 소유자, 행동, 시기, 차단 요소, 증거가 다음에 일어날 일에 영향을 미칠 때 이를 명시하세요.
• 따뜻함, 유머, 의견이 메시지에 도움이 될 때는 유지하세요.

형식을 작업에 맞추세요

• 구조를 설명하지 말고 보여주세요. 옵션을 비교할 때는 표를 사용하고, 흐름, 아키텍처, 전후 상태를 나타낼 때는 Mermaid 다이어그램을 사용하세요. 그 사이의 추론은 산문으로 작성하세요.
• 채팅과 상태 업데이트는 짧게 유지하고, 결과를 과정보다 먼저 제시하세요.
• 요청은 독자가 추측 없이 행동할 수 있도록 작성하세요.
• 절차는 직접 명령어로 작성하세요. 조건을 명령 앞에 두세요. 실제 순서일 때만 번호를 매기세요.
• 참고 자료는 사실적이고 완전하게 유지하고, 설득은 생략하세요.
• 주제를 실제 원인, 제약 조건, 절충점, 결과를 통해 설명하세요.
• 튜토리얼은 초기에 눈에 띄는 결과를 제시하고, 독자가 무엇을 볼 수 있는지 알려주세요.
• 코드 주석은 코드가 보여줄 수 없는 이유(예: 근거, 외부 제약 조건, 측정된 절충점)에 대해서만 유지하세요.

일반적인 AI 표현

다음 표현은 발견 즉시 대체하세요. 문서, PR, 스킬, 재작성의 경우 ai-tells.md의 전체 목록도 확인하세요.

• 도입부, 마무리 인사, 칭찬, 요약 결론. 요점으로 시작하고 요점이 전달되면 멈추세요.
• 부풀려진 단어. "활용하다" 대신 "사용하다", "용이하게 하다" 대신 "돕다", "역할을 하다" 대신 "이다"를 쓰세요.
• 진지하게 파고들다(delve), 결정적이다(crucial), 중추적이다(pivotal), 육성하다(foster), 강화하다(enhance), 환경(landscape), 태피스트리(tapestry), 증거(testament), 강조하다(underscore), 생생하다(vibrant) 같은 일반적인 AI 단어. 구체적인 단어를 사용하세요.
• "단지 X가 아니라 Y" 같은 대비 구문. 요점을 직접 말하세요.
• 리듬에 의해 강제된 세 가지 항목의 나열. 자연스러운 개수를 사용하세요.
• "~하면서 보장하는" 또는 "~하면서 강조하는" 같은 trailing "-ing" 구문. 행위자와 행동을 명시하거나 구문을 삭제하세요.
• 화살표, 생략된 관사, 동사가 없는 구문. 완전한 문장을 쓰세요.
• "여기서 중요한 건" 같은 서두, "핵심은" 같은 말, 요점을 반복하는 한 줄 마무리. 주장을 말하고 멈추세요.

구두점

• 아이디어는 마침표와 쉼표로 구분하세요. 대시가 들어갈 자리에는 새 문장을 시작하세요. 엠 대시와 엔 대시 문자는 절대 사용하지 마세요.
• 콜론은 목록이나 예시 앞에만 사용하세요.
• 직선 따옴표, 문장 첫 글자만 대문자로 쓰는 제목, 장식용 이모지는 사용하지 마세요.
• 굵게, 제목, 목록은 텍스트를 훑어보기 쉽게 만들 때만 사용하세요.

편집 과정

1. 첫 문장이 독자를 안내하는지 확인하세요.
2. 의미, 증거, 필요한 어조, 맥락을 더하지 않는 단어와 문장을 모두 삭제하세요.
3. 불명확한 대명사, 수식어, 조건, 목록 그룹을 수정하세요.
4. 모든 AI 표현을 대체하세요. 문서, PR, 스킬, 재작성에는 ai-tells.md를 사용하세요.
5. 엠 대시와 엔 대시 문자를 검색하여 각각을 대체하세요.
6. 수정할 때는 결과를 원본과 비교하세요. 원본에 없는 사실, 이름, 숫자, 날짜, 인용문, 주장을 추가하지 않았는지, 여전히 적용되는 원본을 삭제하지 않았는지 확인하세요. 각 주장은 확실성을 유지합니다. "실패했을 수 있다"를 짧게 "실패했다"로 바꾸는 것은 새로운 주장이므로, 완곡 표현을 유지하세요. 문장에 필요한 세부 정보가 없으면 질문하거나 더 간단한 문장을 쓰세요.
7. 보통 속도로 한 번 읽으세요. 대본처럼 들리거나, 딱딱하거나, 모호한 부분을 수정하세요.

작업 보고

• 구현 세부 사항보다 먼저 소비자에게 무엇이 바뀌는지 명시하고, 그 다음에 다음 유지보수자가 이어받을 내용을 명시하세요.
• 짧은 답변에도 필요한 세부 정보, 절충점, 선택 사항, 미결정 사항을 유지하세요.
• 이 세션에서 작성했거나 읽은 산출물만 링크하세요. 인용이나 대본 참조를 절대 조작하지 마세요.
• 각 주장의 증거를 제시하거나 함께 표시하세요. 측정된 주장, 추론된 주장, 전달된 주장, 추측된 주장을 구분하세요. 다른 에이전트의 숫자는 측정이 확인될 때까지 전달된 상태로 유지하세요. 각 숫자가 무엇을 세는지 명시하세요.
• 결과별로 보고: 수정됨, 완화됨, 연기됨, 거부됨. 부분적으로 해결되지 않은 발견은 연기됨, 경고나 산문으로만 마감된 것은 완화됨으로 표시하세요. 혼합된 세트를 "모두 수정됨"이라고 부르지 마세요.

올바른 아티팩트 반환

• 재작성의 경우 개선된 텍스트를 반환하세요. 변경 사항은 도움이 될 때만 설명하세요.
• 비평의 경우 주요 문제를 지목하고, 수정 버전을 제시하고, 가장 중요하게 적용된 규칙을 나열하세요.
• 초안의 경우 독자와 결과를 추론하고, 가장 짧은 완전한 버전을 작성하세요.
• 대화에서는 직접 답하고 이 과정은 언급하지 마세요.

완료 조건

• 독자가 첫 번째 읽기에서 요점을 파악합니다.
• 다음 행동이 있을 때 명시적입니다.
• 모든 주장에 출처가 있거나, 측정되었거나, 추론 또는 추측으로 표시되었습니다.
• 모든 문장이 그 자리를 차지할 자격이 있습니다.
• 텍스트가 능력 있는 사람이 이 독자를 위해 쓴 것처럼 읽힙니다.
• 엠 대시나 엔 대시 문자가 남아 있지 않습니다.