yingdao-xbot-ai-agent: xbot/RPA 자동화 및 AI 코딩 에이전트를 위한 중국어 개발 지식 기반

영도(影刀) xbot / 코딩 버전, RPA 자동화 및 AI 코딩 Agent를 위한 중국어 개발 지식 기반입니다.

이는 제가 실제 영도 자동화 프로젝트를 개발하고 유지보수하는 과정에서 개인적인 AI 보조 개발 프로세스를 위해 지속적으로 정리한 지식 기반입니다. 처음에는 저 자신의 프로젝트에 사용되었지만, 공개함으로써 Codex, Claude Code, Cursor 등과 같은 도구를 사용하여 영도 코딩 버전을 개발하는 다른 개발자들에게 참고 자료가 되기를 바랍니다.

본 저장소는 영도의 공식 문서가 아니며 모든 API를 다루려고 하지 않습니다. 여기에 포함된 내용은 주로 개인 프로젝트에서의 실제 호출 사례, 소스코드 검증 및 재현 가능한 문제들에서 비롯되었습니다. 개발 시에는 정식 사실 페이지에 따라 영도 API와 마켓 명령을 사용해야 합니다. 만약 프로젝트 설치 버전이 문서의 진입점을 누락했다면, 업데이트 상태를 확인하고 아직 발표되지 않았거나 문서를 수정해야 할 경우 피드백해 주십시오.

본 저장소가 해결하는 것은 '영도 프로젝트를 어떻게 개발하고 유지보수하며 문제 해결할 것인가'이지, 'AI Agent가 컴퓨터를 어떻게 조작하거나 호스트 도구를 선택해야 하는가'에 대한 내용은 아닙니다. Windows / macOS 접근, 코드 실행, 장치 연결 또는 외부 기능 오케스트레이션 등 ChatGPT, Codex, Claude Code 등의 호스트 측 플러그인, MCP, DevSpace, Computer Use 및 도구 라우팅은 본 프로젝트의 유지보수 범위에 속하지 않습니다. 본 지식 기반에는 영도 자체와 직접 관련된 CLI(Command Line Interface), API, 프로젝트 형식 및 실행 메커니즘만 포함됩니다.

일반적인 코드 모델들은 보통 Python, Selenium, Playwright, pandas 또는 openpyxl에 익숙하지만, 영도 프로젝트 내의 다음 사항들은 본질적으로 알지 못합니다:

• xbot 객체, 요소 라이브러리(element library), 이미지 라이브러리 및 리소스 파일의 실제 사용법.
• 브라우저, Excel/WPS, Windows 자동화 간의 API 경계.
• 마켓 명령이 시각적 인터페이스와 코딩 버전에서 가지는 매개변수 매핑.
• 영도의 실제 프로젝트 디렉토리, package.json 및 동기화 프로세스 간의 관계. - 어떤 결론은 검증되었고, 어떤 것은 현재 환경에서 실행하여 확인해야 하는지.

본 저장소의 목표는 AI가 '더 많은 문서를 기억하게' 만드는 것이 아니라, 불확실할 때 올바른 진입점을 찾게 하고 API 추측이나 구식 경험 복사를 줄이도록 돕는 것입니다.

• AGENTS.md: 지식 기반 자체의 유지보수 규칙입니다. 실제 프로젝트의 상시 개발 규칙은 project-template/AGENTS.md를 참조하십시오.

• llms.txt: AI Agent가 사용할 간소화된 문서 탐색 가이드입니다.

• project-template: 실제 영도 프로젝트에 복사할 수 있는 기본 뼈대(base skeleton), Claude 진입점 및 세 가지 스킬(code-quality, xbot-tools, rpa-practices)을 제공합니다.

• 코드 품질 Skill: 일관성, 단순화, 검토 기능을 제공합니다.

• 영도 도구 Skill: CLI, 프로젝트 생성, 동기화, 배포 및 프로젝트 진단 기능을 포함합니다. scripts/sync_codeflows.py는 Code Flow의 추가/삭제만 처리하며, scripts/publish_app.py는 외부에서 수정된 저장, 동기화, 배포 및 버전 검증을 통합적으로 처리합니다.

• 개발 경험 및 템플릿 Skill: 시나리오별 개발 경험과 예시를 제공합니다. CLI 사용 시에는 로컬에 영도 CLI가 설치되어 있어야 합니다. 기본 골격 및 설정 규칙은 최소 기본 골격을 참조하십시오.

지식 기반 디렉토리: <본 저장소의 로컬 경로>
실제 프로젝트 디렉토리: <영도 프로젝트 경로>
먼저 실제 프로젝트의 AGENTS.md를 읽고, 기존 코드를 확인합니다.
...

동기화가 트리거되는 조건, 실행 명령어 및 검증 경계는 모두 '실제 프로젝트의 동기화 규칙'을 참조하며, 작업 단계는 '영도 도구 Skill'을 참고하십시오.

이것은 개인적으로 지속 유지 관리하는 실용적인 지식 기반이며, 장기간 안정적이고 실제 프로젝트에 반복적으로 도움이 될 수 있는 내용들을 우선적으로 보존하고 있습니다.

• 비즈니스 프로세스 우선 직접적이고 가독성이 높아야 하며, 복잡한 아키텍처를 추구하지 않습니다.
• API 결론은 현재 버전의 소스 코드, 실제 호출 또는 추적 가능한 코드를 근거로 해야 합니다.
• 프로젝트 전용 페이지 필드, 비즈니스 정의(business metrics), 임시 해결책(workaround)은 공통 규칙으로 격상되지 않습니다.
• 문서는 '완벽해 보이게' 하기 위해 동일한 내용을 반복하기보다 고유한 사실 페이지에 링크하는 것이 좋습니다.

만약 문서가 현재 버전과 일치하지 않는 것을 발견하면, Issue 또는 Pull Request를 제출해 주십시오. 기여하기 전에 CONTRIBUTING.md를 읽어보시고, 계정, Token, Webhook, 고객 데이터 및 로컬 경로가 비식별화되었는지 확인하십시오.

AGENTS.md # 에이전트 핵심 제약 조건
llms.txt # AI / LLM 문서 인덱스
README.md # 프로젝트 소개 및 사용 진입점
...

잉다오(影刀), 잉다오 코딩 버전, 잉다오 xbot, 잉다오 API, 잉다오 RPA, 브라우저 자동화, Excel 자동화, WPS 자동화, Windows 자동화, 딩딩 AI 표, 시장 명령, AI 에이전트, Codex, Claude Code, Cursor, Yingdao, xbot API, RPA 자동화, Python 자동화.

사용 중 문제가 발생하거나 잉다오 RPA 또는 AI 코딩 관련 교류가 필요한 경우:

• QQ:
  1677880403

• 이메일:
  [email protected]

• 기술 문제 / 버그: GitHub Issue 제출을 우선해 주십시오.

본 프로젝트는 MIT License를 채택하고 있습니다.