From 47bba8b0faaab1e6f6de973485099dab90ca5adb Mon Sep 17 00:00:00 2001 From: Richard Wall Date: Fri, 6 Nov 2026 13:54:59 +0000 Subject: [PATCH] docs(skills): note Jira comment create cannot reply in a thread - twg jira workitem comment create posts top-level comments only. - Tell agents to link the comment they are answering instead, so they stop looking for a reply option that does not exist. Refs: #28 Co-Authored-By: Claude Signed-off-by: Richard Wall --- skills/twg-jira/references/workitems.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/skills/twg-jira/references/workitems.md b/skills/twg-jira/references/workitems.md index c0fc2b69..b10ef8bb 100644 --- a/skills/twg-jira/references/workitems.md +++ b/skills/twg-jira/references/workitems.md @@ -47,5 +47,11 @@ Before a create or update: For links, resolve both endpoints and discover the supported link type before writing. For comments and descriptions, follow `rich-content.md`. +`twg jira workitem comment create` adds a top-level comment only. It cannot +reply inside an existing comment thread. When answering a specific comment, +start the new comment with a link to it +(`?focusedCommentId=`) and mention its author. Get the +comment ID from `twg jira workitem comment query`. + Do not combine unrelated field, transition, link, and comment changes in one opaque operation. Keep each result independently verifiable.