Komal Vardhan Lolugu
4e8726dd50
azure-devops-cli: handle long comments on Windows ( #2061 ) ( #2140 )
...
* azure-devops-cli: handle long comments on Windows (#2061 )
On Windows 'az' is a cmd.exe batch wrapper capped at ~8191 characters,
so a long --discussion / --description value silently truncates or
fails. Document three verified ways out so the coding agent doesn't
waste 3-5 turns falling back to raw token retrieval and REST:
1. azps.ps1 in PowerShell on Windows. Same Azure CLI, invoked through
the Python entry point with no cmd.exe length cap. Pair with
'Get-Content -Raw' so the body lives in a variable, not on the
command line.
2. Native --file-path flags where Azure CLI offers them. Applies to
'az devops wiki page create' and 'az devops wiki page update', both
documented with --encoding.
3. 'az devops invoke --in-file' as the universal escape hatch for
commands with no --file-path (work-item --discussion, PR
--description). Documented example posts to the work item
comments REST endpoint with api-version 7.0-preview.3.
The earlier draft suggested the Azure CLI '@<file>' convention as a
generic substitute for inline string args. The official docs only
document it for JSON parameters and the CLI source uses
'get_file_json' specifically, so the claim is removed and replaced
with an explicit warning not to rely on it for plain string args.
Files touched:
- skills/azure-devops-cli/SKILL.md: new 'Posting long comments on
Windows' section with shell-detection table and three verified
options.
- skills/azure-devops-cli/references/boards-and-iterations.md: short
pointer at each --discussion example back to SKILL.md, plus an
inline PowerShell snippet.
Closes #2061 .
* azure-devops-cli: move long-comments guidance to reference file (#2061 review)
aaronpowell asked for the Windows long-comments section to live as a
reference file rather than inline in SKILL.md, so the token weight
isn't always loaded into the agent's context.
- Move the "Posting long comments on Windows" section to a new
references/long-comments-on-windows.md verbatim.
- Strip the section from SKILL.md (56 fewer lines in the always-loaded
surface).
- Add the new file to the Reference Files table in SKILL.md with a
one-line "when to read" hint covering --discussion, --description,
and --content failures on Windows.
- Update the two pointer comments in references/boards-and-iterations.md
to point at the new reference file instead of the SKILL.md section.
docs/README.skills.md regenerated by 'npm run build' to pick up the
new reference file in the skill's bundled assets column.
2026-06-29 23:47:06 +00:00
..
2026-04-14 10:29:57 +10:00
2026-05-04 14:11:14 +10:00
2026-05-04 14:11:14 +10:00
2026-05-04 14:11:14 +10:00
2026-02-24 14:39:33 +11:00
2026-05-28 10:09:54 +10:00
2026-03-17 08:31:14 +11:00
2026-04-09 15:33:08 +10:00
2026-04-09 15:33:08 +10:00
2026-01-18 19:39:54 -08:00
2026-02-24 14:39:33 +11:00
2026-05-15 11:18:53 +10:00
2026-04-28 17:33:23 +10:00
2026-01-09 11:25:32 -08:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-04-29 11:15:42 +10:00
2026-05-13 12:08:14 +10:00
2026-05-13 12:08:14 +10:00
2026-05-13 12:08:14 +10:00
2026-05-13 12:08:14 +10:00
2026-05-13 12:08:14 +10:00
2026-05-13 12:08:14 +10:00
2026-05-13 12:08:14 +10:00
2026-05-13 12:08:14 +10:00
2026-05-13 12:08:14 +10:00
2026-02-08 19:53:48 -06:00
2026-02-24 14:39:33 +11:00
2026-04-28 11:46:05 +10:00
2026-03-09 14:46:32 +11:00
2026-03-19 10:29:01 +11:00
2026-03-19 11:02:10 +11:00
2026-06-29 10:53:30 +10:00
2026-06-10 14:43:31 +10:00
2026-06-10 14:43:31 +10:00
2026-06-10 14:43:31 +10:00
2026-06-10 14:43:31 +10:00
2026-02-24 14:39:33 +11:00
2026-05-08 12:26:06 +10:00
2026-01-21 10:39:33 -08:00
2026-06-29 23:47:06 +00:00
2026-03-05 21:53:41 +11:00
2026-02-24 14:39:33 +11:00
2026-01-12 09:53:29 -08:00
2026-01-05 11:31:06 -08:00
2026-04-29 11:15:42 +10:00
2026-01-16 10:42:27 -08:00
2026-04-28 11:29:28 +10:00
2026-02-25 15:09:25 +11:00
2026-02-24 14:39:33 +11:00
2026-04-29 11:09:46 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-01-23 00:18:52 +07:00
2026-06-19 10:20:00 +10:00
2026-03-12 11:53:00 +11:00
2026-02-24 14:39:33 +11:00
2026-04-13 09:52:59 +10:00
2026-03-18 11:15:29 +11:00
2026-02-24 14:39:33 +11:00
2026-05-04 14:22:16 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-05-04 11:12:15 +10:00
2026-02-24 14:39:33 +11:00
2026-05-28 15:06:54 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-12 12:33:46 -08:00
2026-02-24 14:39:33 +11:00
2026-04-15 09:50:39 +10:00
2026-03-06 08:06:55 +11:00
2026-02-17 14:59:25 +00:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-04-28 13:57:46 +10:00
2026-04-28 13:57:46 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-03-11 10:46:06 +11:00
2026-03-11 10:46:06 +11:00
2026-03-11 10:46:06 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-03-27 11:17:04 +11:00
2026-04-28 14:26:20 +10:00
2026-05-05 12:02:58 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-06-15 10:56:29 +10:00
2026-02-24 14:39:33 +11:00
2026-05-06 10:04:36 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-05-11 09:35:26 +10:00
2026-03-23 11:30:33 +11:00
2026-02-24 14:39:33 +11:00
2026-03-12 14:27:52 +11:00
2026-03-27 11:15:53 +11:00
2026-05-01 10:29:26 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-05-25 11:34:34 +10:00
2026-06-18 11:28:03 +10:00
2026-03-27 10:24:47 +11:00
2026-02-21 12:04:15 +01:00
2026-04-28 11:27:48 +10:00
2026-04-20 12:31:29 +10:00
2026-06-11 15:58:22 +10:00
2026-05-01 09:41:12 +10:00
2026-02-17 11:18:43 -08:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-16 17:01:12 +02:00
2026-02-24 14:39:33 +11:00
2026-05-11 11:28:29 +10:00
2026-05-11 11:28:29 +10:00
2026-05-11 11:28:29 +10:00
2026-05-11 11:28:29 +10:00
2026-05-11 11:28:29 +10:00
2026-02-16 22:43:41 +01:00
2026-02-24 14:39:33 +11:00
2026-04-17 10:56:28 +10:00
2026-04-10 11:02:57 +10:00
2026-05-28 10:08:40 +10:00
2026-05-28 10:08:40 +10:00
2026-04-07 13:43:44 -07:00
2026-05-28 10:08:40 +10:00
2026-02-22 23:31:59 -05:00
2026-03-31 10:53:25 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-05-15 11:26:59 +10:00
2026-03-24 16:25:10 +11:00
2026-01-23 00:18:52 +07:00
2026-02-24 14:39:33 +11:00
2026-05-25 11:05:10 +10:00
2026-06-16 11:04:26 +10:00
2026-06-19 10:19:20 +10:00
2026-05-25 11:05:10 +10:00
2026-03-10 10:10:35 +11:00
2026-05-14 17:31:34 +01:00
2026-05-21 15:48:23 +10:00
2026-02-24 14:39:33 +11:00
2026-04-15 09:42:53 +10:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-03-23 11:49:51 +11:00
2026-06-16 11:18:02 +10:00
2026-05-25 11:22:39 +10:00
2026-01-21 16:48:38 +00:00
2026-04-28 13:49:58 +10:00
2026-03-02 19:32:24 +11:00
2026-06-17 14:46:43 +10:00
2026-04-17 10:57:35 +10:00
2026-03-13 07:30:32 +00:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-04-28 16:52:44 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-01-19 20:26:57 -05:00
2026-04-16 08:54:58 +10:00
2026-06-15 10:55:29 +10:00
2026-02-17 15:27:02 -06:00
2026-01-29 00:49:17 -05:00
2026-01-23 00:18:52 +07:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-04-09 15:33:08 +10:00
2026-05-27 11:10:08 +10:00
2026-02-04 06:40:46 +08:00
2026-02-24 14:39:33 +11:00
2026-03-03 10:06:32 +11:00
2026-03-16 10:27:54 +11:00
2026-03-16 11:53:03 +11:00
2026-03-16 11:53:03 +11:00
2026-03-16 11:53:03 +11:00
2026-03-11 10:46:06 +11:00
2026-04-28 11:41:41 +10:00
2026-05-05 14:04:37 +10:00
2026-02-24 14:39:33 +11:00
2026-05-14 11:09:26 +10:00
2026-03-02 11:05:48 +11:00
2026-02-24 14:39:33 +11:00
2026-05-11 11:29:33 +10:00
2026-05-11 11:29:33 +10:00
2026-05-11 11:29:33 +10:00
2026-05-29 21:58:31 +00:00
2026-02-10 10:03:49 +08:00
2026-03-09 15:50:20 +11:00
2026-02-24 14:39:33 +11:00
2026-03-03 10:31:40 +11:00
2026-01-06 21:35:41 +01:00
2026-04-17 10:57:35 +10:00
2026-03-16 10:27:54 +11:00
2026-02-24 14:39:33 +11:00
2026-05-18 11:26:40 +10:00
2026-02-15 21:46:03 -05:00
2026-02-03 10:06:49 +03:00
2026-05-06 14:16:28 +10:00
2026-05-13 12:08:14 +10:00
2026-05-13 12:08:14 +10:00
2026-05-04 11:05:44 +10:00
2026-02-24 14:39:33 +11:00
2026-06-12 10:09:11 +10:00
2026-03-11 10:46:06 +11:00
2026-01-23 00:18:52 +07:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-04-17 10:49:40 +10:00
2026-02-24 14:39:33 +11:00
2026-02-03 12:49:55 +03:00
2026-04-30 09:59:44 +10:00
2026-05-25 11:22:39 +10:00
2026-01-23 00:36:52 +07:00
2026-04-15 09:42:53 +10:00
2026-02-24 14:39:33 +11:00
2026-05-14 10:56:22 +10:00
2026-03-20 10:26:41 +11:00
2026-02-24 14:39:33 +11:00
2026-04-29 11:15:42 +10:00
2026-02-24 14:39:33 +11:00
2026-04-09 10:36:17 +10:00
2026-04-17 10:54:27 +10:00
2026-04-17 10:54:27 +10:00
2026-04-17 10:54:27 +10:00
2026-04-17 10:54:27 +10:00
2026-04-17 10:54:27 +10:00
2026-04-17 10:54:27 +10:00
2026-04-17 10:54:27 +10:00
2026-04-17 10:54:27 +10:00
2026-05-11 11:31:53 +10:00
2026-02-17 20:49:40 -05:00
2026-04-09 15:18:52 +10:00
2026-04-09 15:18:52 +10:00
2026-04-09 15:18:52 +10:00
2026-04-09 15:18:52 +10:00
2026-04-09 15:18:52 +10:00
2026-04-09 15:18:52 +10:00
2026-04-09 15:18:52 +10:00
2026-04-09 15:18:52 +10:00
2026-04-09 15:18:52 +10:00
2026-04-09 15:18:52 +10:00
2026-06-15 10:23:43 +10:00
2026-02-24 14:39:33 +11:00
2026-02-02 00:00:31 -06:00
2026-02-24 14:39:33 +11:00
2026-05-12 09:49:12 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-04-28 12:09:46 +10:00
2026-02-24 14:39:33 +11:00
2026-03-11 10:46:06 +11:00
2026-05-29 11:23:22 +10:00
2026-03-26 09:55:31 +11:00
2026-03-26 09:55:31 +11:00
2026-02-24 14:39:33 +11:00
2026-03-27 11:13:50 +11:00
2026-02-24 14:39:33 +11:00
2026-04-09 12:09:42 +10:00
2026-04-09 12:09:42 +10:00
2026-04-09 12:09:42 +10:00
2026-03-16 10:27:32 +11:00
2026-03-11 10:46:06 +11:00
2026-03-13 09:36:08 +11:00
2026-05-25 11:22:39 +10:00
2026-03-25 09:50:07 +11:00
2026-03-30 11:44:48 +11:00
2026-03-16 10:27:54 +11:00
2026-06-16 11:50:25 +10:00
2026-02-24 14:39:33 +11:00
2026-05-12 12:55:26 +10:00
2026-01-18 14:12:03 +02:00
2026-02-13 18:54:44 -08:00
2026-03-20 10:24:37 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-05-19 10:55:57 +10:00
2026-05-15 11:06:16 +10:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-06-22 11:07:36 +10:00
2026-02-24 14:39:33 +11:00
2026-02-02 08:58:51 +09:00
2026-03-30 07:58:56 +11:00
2026-06-19 10:42:24 +10:00
2026-02-24 14:39:33 +11:00
2026-02-17 15:52:54 +01:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-05-25 11:22:39 +10:00
2026-03-16 10:39:36 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-02-24 14:39:33 +11:00
2026-04-28 13:46:03 +10:00
2026-01-11 13:18:36 -03:00
2026-01-11 13:15:56 -03:00
2026-01-09 10:46:07 +09:00
2026-03-13 13:45:17 +11:00
2026-02-24 14:39:33 +11:00
2026-03-04 09:37:13 +11:00
2026-03-04 10:04:56 +11:00
2026-01-25 22:00:26 -05:00
2026-02-24 14:39:33 +11:00
2026-06-23 14:05:24 +10:00