Squashed 'docs/standards/playbook/' changes from c3f8137..25d895d

25d895d 🐛 fix(gitea_workflow): clean up temp repos after job steps
2bc3b11 🐛 fix(gitea_workflow): clean up temporary repo dirs in workflows
98c3f30 📝 docs(agent_rules): allow plan execution on current branch
16c7230 📝 docs(prompts): define custom verify layering
8efc4dd 🐛 fix(skills): quote commit-message description
bc8498f 🐛 fix(ci): install tomli for gitea tests
55cda3b 🐛 fix(tests): report missing toml parser clearly
c0729c7 🐛 fix(playbook): import Optional for cli compatibility
63e24bf 📦 deps(skills): sync thirdparty skills
d2f9356 🐛 fix(ci): isolate gitea workflow repos
588b81d 🐛 fix(ci): inline gitea workflow bootstrap
e0b1c3a ♻️ refactor(skills): standardize first-party skill contracts
2c5050d ♻️ refactor(skills): rename repo skills source dir
f049dfb 📦 deps(skills): drop duplicate first-party superpowers skills
234b335 ✨ feat(workflow): add superpowers planning and execution state tracking
c1702a6 📝 docs(markdown): format tracked markdown and drop stale templates
2325409 📝 docs(markdown): clarify optional markdownlint usage
214c44e 🔧 chore(markdown): add markdownlint baseline and lint fixes
a22b324 📝 docs(templates): add execution and memory-bank prompt templates
223a797 📝 docs(templates): update README for Claude Code and current features
4ac8672 📝 docs: simplify README + platform-agnostic tools + auto-create local rules
2431c9d 📝 docs: add claude_md config and use cross-platform paths
d64b248 📝 docs: fix README.md inaccuracies and add Claude Code info
c8d6bf2 🐛 fix(playbook): use relative paths in CLAUDE.md when not at project root
6518f0f ✨ feat(playbook): auto-create CLAUDE.md with path discovery
6ec9a45 ✨ feat(skills): add skill_link symlink support + platform-agnostic prompt
9f8b6b5 📝 docs: update README and config example for Claude Code support
79cff6c 📝 docs(skills): add Claude Code platform support
452c6f5 ✨ feat(playbook): auto-inject AGENTS.md into CLAUDE.md
e1dbf3c 🐛 fix(skills): remove dual-path from commit-message skill
f3a7259 🔧 chore(ci): use prepare_repo.sh in both workflows
da08212 🔧 chore(ci): extract prepare_repo.sh and clean up workflows
7ade85e 🗑️ remove(tsl): drop syntax_book/, data/ source and build script
f94dba0 ♻️ refactor(skills): update playbook.py and tests for thirdparty/ layout
b3df412 ♻️ refactor(skills): separate thirdparty skills into thirdparty/ subdirectory
64950e7 📦 deps(skills): sync thirdparty skills
a2e3cb0 ✨ feat(playbook): add no_backup deploy controls
8609d59 🐛 fix(docs): repair reference catalog source links
956da11 🐛 fix(playbook): publish hidden ci test fixes
3f67754 📦 deps(skills): sync thirdparty skills
08ca87b 📦 deps(skills): add karpathy thirdparty sync
96b705b 📝 docs(tsl): rebuild canonical syntax and routing manual
3ed5052 📦 deps(skills): sync thirdparty skills
60108dd 📦 deps(skills): sync thirdparty skills
da85d4e 🐛 fix(thirdparty): prune nested project snapshots
a2a697e 📦 deps(skills): sync thirdparty skills
9df610a 🐛 fix(thirdparty): exclude duplicated superpowers skills
33dd5bb 🐛 fix(thirdparty): preserve optional manifest fields
91b0ea7 🐛 fix(thirdparty): preserve manifest during snapshot update
2e26f98 🔧 chore(thirdparty): generalize skills sync pipeline
5b9c1e3 📦 deps(skills): sync superpowers
2f2d34a 📝 docs(readme): normalize subtree command spacing
62db7db 🐛 fix(ci): serialize superpowers update and sync
3463223 🐛 fix(ci): use literal superpowers sync paths
48f6de8 📦 deps(skills): sync superpowers
4b23529 🔧 chore(ci): merge superpowers update and sync workflow
a56d75b 📦 deps(skills): sync superpowers
84bcefa 🔧 chore(ci): use ci[bot] commit author name
00a07e5 📦 deps(skills): sync superpowers
7b84daf 🐛 fix(templates): enforce main loop progress tracking
51373d7 🔧 chore(ci): automate superpowers sync workflow
eaaa39c 🐛 fix(ci): prevent stale superpowers sync from restoring skills block
79755c6 📦 deps(skills): sync superpowers
836d878 📦 deps(skills): sync superpowers
8216c9f 📦 deps(skills): sync superpowers
9439505 🐛 fix(playbook): address reported repo issues

git-subtree-dir: docs/standards/playbook
git-subtree-split: 25d895d8b3f56624ccfe99ad7289e9eb49e0f316

docs/tsl/modules/tsl_python_interop.md

@@ -1,10 +1,28 @@
 # 天软平台和 Python 的交互
 
+文档类型：模块摘要
+是否可直接用于生成代码：否
+是否含已验证可执行示例：否
+是否含已验证反例：否
+遇到不确定时跳转到：项目级部署文档、对应官方文档、[pytsl_api.md](pytsl_api.md)、[index.md](index.md)
+
+本页用于接入决策和最小链路确认，不替代项目级部署文档。
+
+- 如果登录方式、凭证来源、位数、环境变量、连接通道或部署入口没有确认，不继续生成接入代码，直接回项目级部署文档或对应官方文档。
+
 ## 摘要
 
 - 覆盖三类交互：Python 调用 TSL、TSL 调用 Python、落地服务器开启 Python 服务。
 - 提供 COM/远程登录两种路径，以及 `PyRun`/`PyCall` 体系。
 
+## 怎么选路
+
+| 场景                                | 先选哪条路                 | 最小前置条件                                            | 常见失败点                                           |
+| ----------------------------------- | -------------------------- | ------------------------------------------------------- | ---------------------------------------------------- |
+| Python 作为主控，远程执行或调用 TSL | Python 调 TSL              | Python 环境、TSLPy 模块、可用连接方式（COM / 远程登录） | 位数不一致、环境变量没配好、服务器未登录             |
+| TSL 脚本里需要调用现有 Python 代码  | TSL 调 Python              | TSL 与 Python 位数一致、`PYTHONHOME` 等环境正确         | Python 环境未就绪、模块找不到、网格场景不支持        |
+| 落地服务器侧长期提供 Python 能力    | 落地服务器开启 Python 服务 | 服务端环境、部署权限、可维护的脚本入口                  | 服务端环境和本地环境不一致、依赖未部署、运行权限不足 |
+
 ## 结构索引
 
 - 支持版本
@@ -17,9 +35,12 @@
 
 ## Python 调用 TSL（核心步骤）
 
-1. 配置环境变量（天软目录、Python 目录）。
-2. 加载 TSLPy 模块（直接加载或修改包名）。
-3. 选择连接方式（COM / 远程登录）。
+1. 先确认项目级部署文档里的天软目录、Python 目录、位数、连接通道和登录方式。
+2. 配置环境变量（天软目录、Python 目录）。
+3. 加载 TSLPy 模块（直接加载或修改包名）。
+4. 选择连接方式（COM / 远程登录）。
+5. 登录服务器后，再执行 `RemoteExecute` / `RemoteCallFunc`。
+6. 完成后显式断开连接。
 
 ## 主要接口（Python 侧）
 
@@ -35,12 +56,38 @@
 - `PyCall`（调用 Python 函数，支持命名参数）
 - `PyError` / `PyRelease` / `PyEnsure`
 
+## TSL 调用 Python（核心步骤）
+
+1. 先回项目级部署文档确认位数、`PYTHONHOME`、解释器路径和可用模块。
+2. 用 `PyEnsure` 确认 Python 运行时已经就绪。
+3. 需要把输入传给 Python 时，先用 `PyPutVar` 放入变量。
+4. 选择执行方式：执行整段脚本用 `PyRun`，直接调函数用 `PyCall`。
+5. 需要取回结果时，再用 `PyGetVar` 读取输出变量。
+6. 失败时先看 `PyError`，结束后显式 `PyRelease`。
+
+## 最小前置条件
+
+- Python 与 TSL 位数必须一致。
+- 多版本 Python 需同步设置 `PYTHONHOME`。
+- 落地前先决定是谁主控：Python 主控还是 TSL 主控。
+
 ## do Python 方式
 
 - 适合快速执行 Python 脚本，省去显式接口调用。
 
+## 落地服务器开启 Python 服务（核心步骤）
+
+1. 先回项目级部署文档确认服务入口、部署权限、依赖目录和守护方式。
+2. 在服务器上准备与项目要求一致的 Python 运行时和依赖包。
+3. 放置一个稳定的 Python 脚本或服务入口，先只承载一条最小调用链。
+4. 按项目约定把这个入口接到天软侧的调用路径或调度入口。
+5. 用最小请求先验证“能启动、能调用、能返回”，再扩展业务逻辑。
+6. 再补日志、重启方式和运维监控；如果这些入口还没确认，不继续生成部署代码。
+
 ## 注意事项（精简）
 
 - Python 与 TSL 位数必须一致。
 - 多版本 Python 需同步设置 `PYTHONHOME`。
 - TSL 调 Python 不支持网格调用。
+- 出现调用失败时，优先先检查环境、位数和登录状态，再排查业务逻辑。
+- 如果登录方式、凭证来源、位数、环境变量、连接通道或部署入口任一没有确认，不继续生成接入代码。