yzhao062/agent-style

해결하는 문제

AI 에이전트가 일반적으로 'AI 특징' — 예를 들어 과도한 전환어 사용, 지나친 번호 매기기, 수동태의 남용 — 을 포함한 글을 생성하는 경향을 해결합니다. 이러한 글은 전문적인 기술 문서에서 요구하는 정확성과 명확성을 결여한 경우가 많으며, 본 프로젝트는 기존의 글쓰기 기준을 적용함으로써 AI 에이전트가 기술 전문가처럼 글을 쓸 수 있도록 체계적인 방법을 제공합니다.

작동 방식

이 프로젝트는 21개의 영문 글쓰기 규칙(스트랭크 & 화이트, 오웰 등에서 선정한 12개의 전통적 규칙과 2022~2026년 LLM 출력 관찰을 통해 도출된 9개의 현장 규칙)을 체계적으로 제공합니다. 이 규칙들은 AI 에이전트에 두 가지 방식으로 통합됩니다:

1. 소프트 강제: 규칙은 생성 시점에 에이전트의 시스템 프롬프트나 프로젝트 설정에 로드되어, 첫 번째 초안 작성 시 모델이 규칙을 따르도록 유도합니다.
2. 스킬 기반 검토: 선택적 2단계 검토(style-review)를 통해 초안이 규칙에 부합하는지 분석하고, 다듬어진 버전을 생성합니다.

대상 사용자

• AI 코딩 및 글쓰기 에이전트(예: Claude Code, Cursor, GitHub Copilot, Aider, Codex) 및 그 사용자.
• 에이전트 설정 유지보수자로서 생성된 기술 문서가 일반적인 LLM 패턴이 아닌, 문헌 기반의 규범을 따르기를 원하는 사람.

주요 특징

• 이중 규칙 세트: 고전적인 글쓰기 가이드와 2022~2026년 LLM 출력 관찰을 통해 도출된 규칙을 결합.
• 광범위한 통합: Claude Code, Cursor, Copilot 등 인기 있는 AI 도구용 다양한 어댑터를 지원.
• 기계적 검증: 여러 주요 모델에서 'AI 특징' 위반 사례가 현저히 감소함을 보여주는 타당성 벤치마크 포함.
• 기술적 범위: API 문서, 설계 문서, 연구 논문, README에 특화되어 있으며, 소설 및 마케팅 콘텐츠는 명시적으로 제외.