René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"issue_write body parameter overwrites issue content on update — easily confused with adding a comment","articleBody":"### Describe the feature or problem you'd like to solve\n\nWhen using issue_write with method: \"update\", passing a \body parameter **replaces the entire issue body**. This matches the REST API semantics, but LLM agents frequently misinterpret \body as \"write a comment about this issue\" rather than \"replace the issue's entire description\". The result is silent data loss — the original issue body gets wiped and replaced with a closing note.\n\n### Proposed solution\n\nTwo possible approaches:\n\n1. **Add a prominent warning** in the \body parameter description, e.g.: \"WARNING: This replaces the entire issue body on update, not append. Use add_issue_comment to add a comment.\"\n2. **Add a comment parameter** to issue_write as a convenience — when provided on method: \"update\", it posts a comment instead of modifying the body.\n\nOption 2 reduces unnecessary round-trips (close issue + add comment = 2 calls becomes 1).\n\n### Example prompts or workflows\n\n1. \"Close issue `#42`and explain why it was fixed\" — agent should NOT touch the original body, but currently tends to overwrite it\n2. \"Mark issue `#17` as duplicate and leave a note\" — agent replaces body with \"duplicate of #X\" instead of commenting\n3. \"Update issue `#8` status to closed with resolution\" — body gets silently destroyed\n\n### Additional context\n\nThis was encountered using **OpenCode** (CLI-based AI coding tool) with **DeepSeek V4 Flash** model, connecting via the GitHub MCP Server (local binary). The \body field name is especially misleading for LLMs because in natural language, \"body of a message\" typically means the message content itself, not the metadata/description of the thing being acted upon.","author":{"url":"https://github.com/Small-tailqwq","@type":"Person","name":"Small-tailqwq"},"datePublished":"2026-04-30T17:54:56.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/2410/github-mcp-server/issues/2410"}