From 419d70ab948bb88dbbb004c6764ada7ce787bf96 Mon Sep 17 00:00:00 2001 From: wantsong Date: Thu, 18 Jun 2026 01:48:58 +0800 Subject: [PATCH] Document repository temp and UTF-8 defaults --- AGENTS.md | 2 ++ docs/installation.md | 9 ++++++++- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 7bb4a50..520a4e1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -36,6 +36,8 @@ If an automation Skill becomes a dependency of a CCPE runtime, agent, or committ - Keep Skill directories self-contained. - Use lowercase kebab-case for Skill names and file names. - Run Python code and tests through the shared `skills-vault` conda environment by default, for example `conda run -n skills-vault python ...`. Use another environment only when a concrete dependency conflict requires it. +- Use repository-local temporary paths for tests by default, under `C:\Users\wangq\Documents\Codex\skills-vault\tmp`, instead of relying on the Windows user temp directory. +- Read and write repository text files as UTF-8 by default. In PowerShell, pass `-Encoding UTF8` for file reads/writes when the cmdlet supports it; do not rely on GBK or other system-default encodings. - Preserve behavior during first migration; refactor only after baseline behavior is captured. - Add tests for transformations, file rewrites, parsing behavior, and safety checks when practical. - Do not write secrets, tokens, machine-specific credentials, or generated cache files into the repository. diff --git a/docs/installation.md b/docs/installation.md index ab66ef4..2b1f158 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -59,7 +59,7 @@ conda run -n skills-vault python -B C:\Users\wangq\.codex\skills\.system\skill-c Do not rely on bare `python` unless you have first verified it resolves to `C:\Users\wangq\.conda\envs\skills-vault\python.exe`. -If pytest cannot access the default Windows temp directory, point `TMP` and `TEMP` at a repository-local ignored directory before running tests: +Use repository-local temp paths for tests by default. Point `TMP` and `TEMP` at an ignored directory under `tmp\` before running pytest, instead of relying on the Windows user temp directory: ```powershell New-Item -ItemType Directory -Force -Path tmp\pytest | Out-Null @@ -68,6 +68,13 @@ $env:TEMP = $env:TMP conda run -n skills-vault pytest skills\voice-generation\tests -q ``` +Repository Markdown, docs, fixtures, and other text files are UTF-8 by default. In PowerShell, prefer explicit UTF-8 reads/writes, for example: + +```powershell +Get-Content -LiteralPath README.md -Encoding UTF8 +Set-Content -LiteralPath output.md -Value $text -Encoding UTF8 +``` + ## Install One Skill PowerShell: