meech-ward

comment-loop

Work through the open comments people left on notes, drawings and diagrams in an elaborat.ing project. Makes each requested change and replies in the thread; the person resolves it. Use when the user asks to address, answer or work through comments, review feedback or requested changes in elaborat.ing.

meech-ward 0 Actualitzat fa 3 setm.
GitHub

Instal·la

npx skillscat add meech-ward/elaborat-ing/comment-loop

Instal·la des del registre de SkillsCat.

SKILL.md

Work through comments

The user's instructions win over this skill when they differ, for example when
they ask you to resolve threads or to handle only some of them.

  1. Find the project with list_projects. Ask when more than one could be meant.
  2. Call list_comments with the project_id and ask_agent: true. It returns
    the open threads the user asked an agent about ("Ask an agent" in the app),
    from every file, each with its path and the file's version, and a
    revision. When the user asks again later, pass that revision as since
    for only the threads asked about after it. If there are none, tell the user
    nothing is asked (or nothing new since last time) and stop. Other threads,
    including other people's, are not yours to work on. Only when the user
    explicitly asks for every comment, call list_comments with no path for
    how many open threads each file has, then with each file's path for its
    threads. If you can subscribe to MCP events, you can watch the project for
    comment.created instead of calling list_comments again and again.
  3. For each file, read_file for its content and version.
    • anchor says what a thread is about: quoted text and its line, a note's
      heading, a drawing element, or the whole file.
    • attached: false means that text or element is gone. Judge from
      original_quote, and ask the user when the intent is unclear.
    • A thread whose last comment is your own earlier reply (via_agent) is
      waiting on the person. Skip it unless they replied after you.
  4. Make the change each comment asks for, and nothing else. Save with
    write_file and the base_version you read. A save returns the file's new
    version: use it for your next save of that file. If the result is a
    conflict, read the file again, merge your change in and save again.
    • Diagram comments sit on the .excalidraw canvas; change the diagram by
      editing its .d2 source.
  5. Reply in each thread with reply_comment: one or two plain sentences on what
    you changed, and version: the file's new version from your save, so the
    reply links to the change. If a request is unclear, or you think it is
    wrong, ask or say so in the reply instead of changing the file.
  6. Leave the threads open. The person resolves each one after checking your
    change. Use resolve_comment only when the user asks you to.
  7. End with a short summary: what changed in each file, and which threads are
    waiting for the person. Offer to show a changed file with show_file.

Categories