주요 콘텐츠로 건너뛰기
TaskForge 3.0: 작업 읽는 AI

Copilot은 다른 파일과 마찬가지로 할 일을 편집할 수 있습니다

VS Code의 Copilot 에이전트 모드는 열려 있는 워크스페이스의 파일을 읽고 씁니다. 지금 바로 그곳에서 Obsidian 보관함을 열면, 일반 마크다운 줄인 작업도 그저 편집할 수 있는 파일 중 하나가 됩니다. TaskForge는 보관함에 TaskForge/Settings/agents.md 안내 파일을 더해 Copilot이 추측 대신 정확한 형식을 맞추게 합니다. 자유 형식 편집 대신 타입이 있는 도구를 원하시나요? VS Code는 MCP를 지원하며, 역시 TaskForge에 포함되는 taskforge 서버도 그대로 연결됩니다.

보관함을 열고 모드를 고르세요

Copilot의 에이전트 모드는 워크스페이스의 파일을 직접 편집하며, 그 자체로 충분합니다. 에이전트가 줄을 직접 쓰는 대신 add와 complete 도구를 호출하게 하고 싶다면 MCP 서버가 있습니다.

  1. 보관함 안내 파일 생성하기

    TaskForge 3.0 이상에서 보관함을 열고 설정 > AI 및 에이전트로 가서 ‘에이전트 파일 생성’을 켜 두세요. TaskForge가 작업 형식을 설명하는 TaskForge/Settings/ 폴더를 기록해, Copilot이 내 표기 방식대로 작업을 쓰게 합니다.

  2. 보관함을 VS Code에서 폴더로 열기

    파일 > 폴더 열기(File > Open Folder)에서 보관함을 선택하세요. 이제 Copilot은 TaskForge/Settings/의 안내 파일을 포함한 모든 노트를 워크스페이스의 일부로 봅니다.

  3. 에이전트 모드를 켜고 안내 파일을 가리키기

    Copilot Chat 패널에서 에이전트 모드로 전환하면 파일을 편집할 수 있습니다. 작업을 추가하거나 바꾸기 전에 TaskForge/Settings/agents.md를 읽으라고 지시하세요. 같은 지시를 .github/copilot-instructions.md에 넣어두면 모든 세션에 적용됩니다.

    # .github/copilot-instructions.md
    이 폴더는 Obsidian 보관함입니다. 작업을 추가하거나 편집하기 전에
    TaskForge/Settings/agents.md를 읽고 정확한 문법을 따르세요.
    Copilot이 가이드를 읽은 다음, 다른 도구가 읽을 수 있는 작업 줄을 씁니다.
  4. 또는 taskforge MCP 서버 추가하기

    VS Code는 MCP 서버를 지원합니다. taskforge를 추가하면 Copilot의 에이전트가 데스크톱 클라이언트가 쓰는 것과 같은 타입이 있는 도구, 즉 add_task, query_tasks, complete_task 등을 얻습니다.

    // .vscode/mcp.json
    {
      "servers": {
        "taskforge": {
          "command": "npx",
          "args": ["-y", "taskforge-md", "mcp", "--stdio"],
          "env": { "TASKFORGE_VAULT": "/path/to/your/vault" }
        }
      }
    }
    npx가 첫 실행 때 taskforge-md를 내려받습니다. TASKFORGE_VAULT를 보관함 경로로 설정하세요.

Copilot이 내 형식을 정확히 맞추는 방법

어느 쪽이든 TaskForge/Settings/ 폴더가 기준이 됩니다. 에이전트 모드는 agents.md를 워크스페이스 파일로 읽고, MCP 서버는 같은 데이터를 리소스로 노출합니다. 그래서 Copilot은 일반적인 체크박스 대신, 이름이 바뀐 필드와 상태 기호까지 포함한 내 표기 방식대로 작업을 씁니다.

TaskForge/Settings/agents.md 작업 문법을 평문으로 설명하며, Copilot 지시가 가리키는 파일입니다.
TaskForge/Settings/dialect.json 기계가 읽을 수 있는 버전으로, MCP 서버에 taskforge://dialect로 노출됩니다.
TaskForge/Settings/spaces.json 저장된 스페이스와 새 작업이 들어갈 위치를 담아, 이름이 지정된 스페이스에 기록된 작업이 올바른 노트로 가게 합니다.

실제로 통하는 프롬프트

보관함을 에이전트 모드로 연 채로 채팅 패널에서 Copilot에게 요청하세요. 안내 파일을 읽고 마크다운을 편집한 다음, 변경 내용을 승인할 수 있는 diff로 보여줍니다.

Copilot에게 묻는 말

“standup.md를 읽고 제 할 일을 전부 tasks/this-week.md에 추가해줘. 마감은 금요일.”

파일에 기록되는 내용

- [ ] 배포 런북 업데이트하기 📅 2026-07-10

- [ ] 마이그레이션 PR 검토하기 📅 2026-07-10

Copilot이 노트와 안내 파일을 읽은 다음 보관함의 문법으로 두 줄을 쓰고 승인할 수 있도록 diff를 준비합니다.

Copilot에게 묻는 말

“배포 런북 작업을 완료 표시하고, 다음 주 월요일에 스테이징에서 테스트하는 후속 작업을 추가해줘.”

파일에 기록되는 내용

- [x] 배포 런북 업데이트하기 ✅ 2026-07-07

- [ ] 스테이징에서 런북 테스트하기 📅 2026-07-13

첫 번째 작업을 그 자리에서 완료 처리하고 후속 작업을 덧붙입니다. TaskForge가 다음에 보관함을 읽을 때 둘 다 보여줍니다.

편집은 워크스페이스 안에 머무릅니다

Copilot의 에이전트는 연 폴더 안의 파일을 편집하며, taskforge MCP 서버를 추가한다면 그것도 로컬에서 실행됩니다. TaskForge 계정도, 작업의 클라우드 사본도 없습니다. 이미 쓰고 있는 iCloud, Dropbox, Obsidian Sync가 편집 내용을 다른 기기로 옮깁니다.

자주 묻는 질문

GitHub Copilot이 정말로 제 Obsidian 작업을 편집할 수 있나요?

네, 에이전트 모드에서 가능합니다. Copilot의 에이전트는 열려 있는 VS Code 워크스페이스의 파일을 읽고 쓰므로, 보관함을 연 상태라면 마크다운 작업 줄을 직접 편집합니다. TaskForge/Settings/agents.md를 먼저 읽으라고 하면 작업이 내 형식대로 나옵니다.

MCP 서버가 필요한가요?

아니요. 대부분의 경우 에이전트 모드로 파일을 편집하는 것만으로 충분합니다. Copilot이 줄을 직접 편집하는 대신 add_task나 complete_task 같은 타입이 있는 도구를 호출하게 하고 싶을 때만 taskforge MCP 서버를 추가하세요. VS Code는 MCP를 지원하므로 둘 다 동작합니다.

GitHub 저장소가 있어야 하나요?

아니요. VS Code에서 연 어떤 폴더든 워크스페이스가 되며, 일반 Obsidian 보관함도 마찬가지입니다. Copilot은 git 저장소인지 신경 쓰지 않지만, 보관함을 git으로 버전 관리해두면 에이전트가 하는 어떤 편집에도 든든한 안전장치가 됩니다.

작업이 TaskForge 앱에도 나타나나요?

네. Copilot은 TaskForge가 읽는 것과 같은 마크다운 파일을 편집합니다. 그 기기에서는 앱이 변경 사항을 즉시 보여주고, 보관함 동기화가 실행되면 휴대폰에도 도착합니다.

Copilot은 제 작업 문법을 어떻게 아나요?

TaskForge가 보관함에 기록하는 안내 파일인 TaskForge/Settings/agents.md를 읽습니다. 그 파일이 정확한 표기 방식을 설명하므로, Copilot은 일반적인 작업이 아니라 다른 도구가 읽을 수 있는 작업을 씁니다.

관련 설정

Copilot은 여러 에이전트 중 하나일 뿐입니다. AI 개요 페이지는 전체 그림을 다루고, MCP와 CLI 페이지는 각 방법을 자세히 다룹니다.

코드를 쓰는 곳에서 작업을 관리하세요.

Copilot이 편집하는, 내 보관함 속 일반 마크다운. TaskForge는 iPhone, iPad, Mac, Android, Windows에서 무료로 다운로드할 수 있습니다.