fix-ado-comment-markdown
Installation
SKILL.md
Fix ADO Comment Markdown
調用方式(明確調用): 本 skill 只在使用者明確調用時執行——Claude Code 用
/fix-ado-comment-markdown,Codex CLI 用$fix-ado-comment-markdown;未被點名時不要自動套用。
本 skill 涵蓋兩件事:ADO 留言的 Markdown 發布/修復(A、B 流程),以及通用 Markdown 校正工具(C 節,內附)。
ADO 留言的儲存格式由每則留言的 format 欄位決定(markdown 或 html),不是由內容決定。az boards work-item update --discussion 與 JSON Patch /fields/System.History 只會存成 html;把多句話塞進一段時,在 ADO 上會黏成一大段。發布與修改留言一律走 Comments REST API 並指定 format=markdown,送出前用內附的 Markdown 校正工具校正語法。
工具都在本 skill 目錄下:scripts/ado_comments.py(只用 Python 標準函式庫,透過 az rest 呼叫)與 scripts/markdown-fixer.mjs(零依賴 Node)。以下 <skill> 指本 skill 目錄(例如 ~/.agents/skills/fix-ado-comment-markdown),$T 指 <skill>/scripts/ado_comments.py,$MF 指 <skill>/scripts/markdown-fixer.mjs。先設定:
export ADO_ORG=https://dev.azure.com/<org> ADO_PROJECT=<project>
草稿與 manifest 放在暫存或 scratchpad 目錄,不放進專案工作樹。