wantsong
/
skills-vault
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document repository temp and UTF-8 defaults

This commit is contained in:
wantsong 2026-06-18 01:48:58 +08:00
parent 287ef86eca
commit 419d70ab94
2 changed files with 10 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
AGENTS.md
View File

@ -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.

9
docs/installation.md
View File

@ -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: