エージェント出力契約

目的

pi や他のエージェントが、こちらの環境に合わないコマンドを出して QOL を下げるのを防ぐ。

追加したスキル

グローバル pi skill として以下を追加した。

~\.pi\agent\skills\paste-safe-windows-ps\SKILL.md

(~ は Windows のユーザーホーム $env:USERPROFILE 相当)

名前:

paste-safe-windows-ps

役割:

• Windows 11 + PowerShell 7 + Firefox 前提でコマンドを出す
• コピペ時の改行事故を避ける
• bash / PowerShell の方言違いを避ける
• 実行用ブロックと説明を分ける

エージェントに期待する回答形式

<repo> はローカルクローン先。最初に貼れる1行を出す。

PowerShell 7 / paste this:

cd "<repo>"; .\.venv\Scripts\mkdocs.exe serve

その後に説明を書く。

What it does:
- プロジェクトに移動する
- venv内のMkDocsを起動する

禁止したい出し方

cd とパスの分離

cd
<repo>

PowerShell に bash の activate を出す

.venv/Scripts/activate

説明コメントだらけの貼り付けブロック

# まず移動します
cd "<repo>"
# 次に起動します
mkdocs serve

自分用の合言葉

エージェントの出力が怪しいときは、こう指示する。

PowerShell 7向けに、1行コピペで出して。Firefoxで折り返されても壊れない形にして。

検証コマンド

スキル編集後は必ず検証する（リポジトリルートに scripts/validate-skill.ps1 がある場合）。

cd "<repo>"; pwsh -NoProfile -File scripts\validate-skill.ps1