用途：为当前机器配置 pi 的两个辅助命令，以及可选的 Windows 终端行为。piw <分支名> [基础commit/分支] 新建分支和 worktree（POSIX 为 ../pi-<分支名>，PowerShell 为 ..\pi-<分支名>）后直接进入 pi；piw-clean [分支名] 在 worktree 内不带参数清理当前 worktree，在主仓库带分支名清理对应 worktree，删分支前按 patch-id 判断内容是否已进 base，squash / rebase 合并的分支也能删除，确有未合并改动的分支保留并说明。
使用方式：先探索环境，判断平台与用户实际使用的 shell；POSIX shell 使用 references/piw-commands.md，Windows PowerShell 使用 references/piw-commands-windows.md，只写取得用户确认的文件。写入后需验证：POSIX 新开交互 shell 跑 type piw piw-clean，bash 下再确认函数块位于非交互 guard 之前；PowerShell 新开会话跑 Get-Command piw,piw-clean 并确认 $PROFILE 为 UTF-8 带 BOM。
Windows 可选附加行为：$PROFILE 末尾包装 prompt，向终端输出 OSC 9.9 上报当前目录（仅 FileSystem provider）；WT settings.json 的 actions 加入 { "command": "duplicateTab", "keys": "ctrl+shift+t" }，Ctrl+Shift+T 由 newTab 变为复制当前标签并继承目录。生效条件：profile 改动需重开终端或 . $PROFILE，WT 保存后热加载；git-bash 路径不做 cwd 跟踪。
限制：worktree 有未提交改动时会强制删除，改动丢失，须先向用户说明；Windows PowerShell 的 $PROFILE 必须存为 UTF-8 带 BOM；已有同名函数会整体替换；$PROFILE 已有非 ASCII 内容且编码不符时需停下询问，不可整体转码。其他平台或细节暂未提供。