docs(skill): place PTOAS venv inside the checkout - #1311
Open
mouliangyu wants to merge 2 commits into
Open
Conversation
Move the isolated venv from the parent directory to /.venv so the workspace stays self-contained and global python/ptoas/conda environments are never used. Update the ptoas-development skill contract, probe, and initialize snippets, and sync the README instructions (zh/en).
The venv now lives at /.venv, so section 3.0 must clone PTOAS before ; otherwise the destination directory does not exist yet. Move the clone from section 3.3 to section 3.0 and drop the now-duplicate clone step (zh/en).
mouliangyu
marked this pull request as ready for review
August 20, 2026 12:14
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.
变更内容
将 PTOAS 的隔离虚拟环境（venv）位置从父目录（
$PTO_SOURCE_DIR/../.venv）统一为工作区内（$PTO_SOURCE_DIR/.venv），使工作区自包含，避免误用全局python/ptoas/ conda 环境。背景
ptoas-developmentskill 之前允许在 checkout 父目录创建 venv（README standard layout），而ptoas-workspace-manager创建的 worktree 一直是 venv 在内部。两种布局并存导致 agent 在探测时可能被旧缓存/全局环境带偏。本次统一为工作区内布局，与 manager 一致。改动文件
.agents/skills/ptoas-development/SKILL.md：workspace contract 的VENV_DIR改为$PTO_SOURCE_DIR/.venv；probe 脚本移除父目录 fallback；initialize 段 venv 创建位置改为工作区内README.md/README_en.md：venv 创建与激活路径同步更新为$PTO_SOURCE_DIR/.venv验证
quick_validate.py .agents/skills/ptoas-development→Skill is valid!