docs(skills): add cross-platform notes so Windows users translate shell examples#489
Merged
Merged
Conversation
…ll examples Built-in skills and the cowork assistant rules document shell commands using macOS/Linux (bash/zsh) syntax — heredocs, `&&` chains, `$(...)`, `python3`, `~/` paths, `grep`/`jq` pipes. The execution tool is OS-neutral and the runtime already runs on Windows, but the command text still assumes UNIX, so a model can copy the examples verbatim and fail on Windows (cmd/PowerShell). This is a purely additive fix: insert a "Platform note" block right after the frontmatter of every skill/rule file that contains runnable commands. No existing command is changed (diff is additions-only), so macOS/Linux behaviour is unchanged and there is no regression risk. On Windows the note gives the model an explicit bash→PowerShell translation table instead of relying on it to infer the difference. Scope: - 19 command-heavy skills get the full translation table (officecli-*, moltbook, morph-ppt[-3d], openclaw-setup, aionui-config/-troubleshooting/-webui-public, story-roleplay, mermaid, auto-inject/officecli, auto-inject/aionui-skills) - 4 python/path-only skills get a short note (pdf, x-recruiter, xiaohongshu-recruiter, auto-inject/skill-creator) - cowork assistant rules get a localized guard (zh-CN / en-US / ru-RU) Skills with no runnable commands are intentionally left untouched. Command rewrites (heredoc → temp file, etc.) are deliberately out of scope. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
piorpua
pushed a commit
that referenced
this pull request
Jun 18, 2026
🤖 I have created a release *beep* *boop* --- ## [0.1.32](v0.1.31...v0.1.32) (2026-06-18) ### Features * **team:** centralize team MCP prompt governance ([#490](#490)) ([5485a95](5485a95)) ### Bug Fixes * **acp:** recover dead ACP connections ([#487](#487)) ([8264873](8264873)) * **conversation:** upsert streaming tool calls (AIO-30) ([#484](#484)) ([a0b3737](a0b3737)) ### Documentation * **skills:** add cross-platform notes so Windows users translate shell examples ([#489](#489)) ([e03b030](e03b030)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
内置 skills 和 cowork 助手规则里的命令示例几乎都是 macOS/Linux(bash/zsh)写法 —— heredoc、
&&链、$(...)、python3、~/路径、grep/jq管道。执行工具本身已经是中性的(不限 bash)、运行时也已支持 Windows,但命令文案仍假定 UNIX,导致模型在 Windows 上可能照抄示例直接执行而失败(参见 cowork.zh-CN 里 "Bash - 命令执行" /python skills/...等)。改动
纯增量修复:在每个含可执行命令的 skill/规则文件 frontmatter 之后插入一段 "Platform note"。
范围
刻意不动:无可执行命令的 skill(weixin-file-send、aionui-webui-setup、cron);命令本身的重写(heredoc → 临时文件等)不在本 PR 范围。
验证
git diff --numstat确认所有文件均为N 0(additions-only),无删除、无命令改动🤖 Generated with Claude Code