pasm-skills 0.4.1__tar.gz

pasm_skills-0.4.1/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: pasm-skills
+Version: 0.4.1
+Summary: PASM 智能体基座 —— 写/跑基于 PASM 引擎的智能体：SDK（BaseAgent）+ 智能体框架 + 场景仿真 + 技能包打包工具
+Author: arronzheng
+License: MIT
+Project-URL: Homepage, https://gitee.com/arronzheng/pasm-skills
+Project-URL: Repository, https://github.com/arronJack/pasm-skills
+Project-URL: Source, https://gitee.com/arronzheng/pasm-skills
+Project-URL: Issues, https://gitee.com/arronzheng/pasm-skills/issues
+Keywords: pasm,agent,agent-framework,agent-sdk,cognition,memory,emotion,long-run,verification,skill-package
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: torch
+Requires-Dist: torch; extra == "torch"
+
+# PASM Skills · 智能体基座
+
+> **本仓是基座：只提供"写智能体"的能力，不提供成品智能体。**
+> 想直接拿现成的智能体用（游戏 NPC / 老人陪伴 / 学习陪伴 / 长期验证），
+> 装独立公开仓 **pasm-agents**。
+>
+> ```bash
+> pip install pasm-skills      # 基座：SDK + 框架 + 打包工具（零依赖）
+> pip install pasm-agents      # 成品智能体集（依赖本基座）
+> ```
+
+基座给你三样东西：
+
+| | 是什么 | 入口 |
+|---|---|---|
+| **📖 使用教程** | 从"这是干什么的"到"写出并发布一个智能体"，走一遍 | **[`docs/TUTORIAL.md`](docs/TUTORIAL.md)** |
+| **SDK** | `BaseAgent` —— 记忆 / 情绪 / 动作 / 反馈 / 持久化开箱可用 | `from pasm_skills.sdk import BaseAgent` |
+| **框架** | 智能体基类与注册表、仓隔离探测、场景仿真底座、核心契约检查工具箱 | `from pasm_skills.agent import Agent, register` |
+| **打包** | 把智能体打成平台可直接上传的技能包（两种归档形态） | `from pasm_skills.build import SkillSpec, run_cli` |
+
+---
+
+## 一、30 秒写一个智能体
+
+```python
+from pasm_skills.sdk import BaseAgent
+
+class TeaHouseOwner(BaseAgent):
+    def action_pool(self):                  # 能做什么
+        return ["greet", "brew", "gossip", "rest"]
+
+    def _render_reply(self, text, facts, mood):   # 怎么回
+        tone = "蔫" if mood < -0.2 else "乐"
+        return f"（{tone}）{self.persona.get('name')}：来了您呐"
+
+a = TeaHouseOwner(agent_id="owner", persona={"name": "王掌柜", "temper": 0.6, "energy": 0.3})
+a.observe("客人夸今年的龙井好", salience=3, tags=["茶"])   # 写记忆（重要度参与淘汰）
+print(a.act())                                  # 'brew' / 'greet' / ...
+print(a.chat("生意怎么样"))                      # 走 _render_reply
+print(a.mood)                                   # 情绪（属性，不加括号）
+a.feedback("praise", action="brew")             # 显式夸"brew"这个动作 → 它会更常出现
+a.save()                                        # ~/.pasm-agents/owner/
+```
+
+跑一个完整走查（8 个环节 + 反馈塑形的实测对比）：
+
+```bash
+git clone https://gitee.com/arronzheng/pasm-skills
+cd pasm-skills
+python examples/build_your_agent.py
+python templates/agent_template.py        # 骨架自带的冒烟
+```
+
+**手把手教程**：[`docs/BUILD-AGENT.md`](docs/BUILD-AGENT.md)
+
+---
+
+## 二、基座负责什么 / 不负责什么
+
+| 基座负责 | 基座不负责 |
+|---|---|
+| ✅ 记忆写入 / 重要度淘汰 / 检索 | ❌ 具体某个智能体的人格与话术 |
+| ✅ 情绪状态与渲染（有 torch 时接真人格模块） | ❌ 具体业务逻辑（用药提醒、选题策略…） |
+| ✅ 动作选择（性格基线 + 反馈塑形） | ❌ 调用哪个大模型（**基座零 LLM 依赖**） |
+| ✅ 状态落盘与跨进程恢复 | ❌ 具体智能体的测试与验收标准 |
+| ✅ 档位检测与如实降级标注 | ❌ 替你把降级藏起来 |
+| ✅ 技能包打包（两种归档形态） | ❌ 替你上传到平台 |
+
+**基座不内置任何智能体**，这是刻意的：`python -m pasm_skills list` 在干净环境下
+会显示 0 个智能体，并提示你装一个。
+
+---
+
+## 三、档位透明（永不隐藏降级）
+
+| tier | 依赖 | 得到什么 |
+|---|---|---|
+| `light` | 无 | 纯内置：重要度淘汰 + 字面检索 + 性格/反馈加权 |
+| `core` | 能 `import pasm.cognitive`（**不需要 torch**） | 真 `memory_layers`（分层记忆）+ `learning.LearningEngine` |
+| `bionic` | 上面 + torch | 再加真情绪 / 人格模块 |
+
+**三个档位下接口完全一致** —— 调用方不写分支，但 `agent.tier` 一定会如实告诉你现在在哪一档。
+
+---
+
+## 四、目录
+
+```
+pasm-skills/
+├── pasm_skills/                 ★ 基座本体
+│   ├── sdk/                     ★ SDK：BaseAgent（写智能体从这里开始）
+│   │   └── base.py              记忆 / 情绪 / 动作 / 反馈 / 持久化 + 两个适配层
+│   ├── agent.py                 框架：Agent 基类 / AgentResult / Finding / 注册表
+│   ├── discovery.py             智能体发现（entry points / PASM_SKILLS_PATH）
+│   ├── context.py               仓隔离探测（RepoContext）
+│   ├── scenarios.py             场景仿真底座（解释器择优 / PRELUDE / 阈值判定）
+│   ├── checks.py                核心契约检查工具箱
+│   ├── build.py                 ★ 技能包打包库（两种归档形态）
+│   └── cli.py                   pasm-skills 命令行
+│
+├── templates/                   ★ 脚手架：复制就能改
+│   ├── agent_template.py        智能体骨架（自带冒烟）
+│   └── SKILL.template.body.md   技能正文模板
+│
+├── examples/                    可跑示例（不依赖任何成品智能体）
+│   └── build_your_agent.py      从零到落盘的完整走查
+│
+├── skill/                       ★ 基座自己的技能正文
+│   └── SKILL.authoring.body.md  「怎么写 PASM 智能体 + 打技能包」
+│
+├── tools/
+│   └── build_skill.py           声明本仓技能 → 调用 pasm_skills.build
+│
+└── docs/
+    ├── TUTORIAL.md              ★ 使用教程（先读这个）
+    ├── BUILD-AGENT.md           ★ 手把手：从零做一个智能体
+    ├── SKILL-FORMAT.md          ★ 技能包格式与两种归档形态
+    ├── ARCHITECTURE.md          框架分层与设计取舍
+    └── SERVER-NEEDS.md          服务器需求评估（结论：不需要）
+```
+
+---
+
+## 五、命令行
+
+```bash
+python -m pasm_skills selftest        # 自检：SDK / 框架 / 发现机制（零依赖）
+python -m pasm_skills list            # 已发现的智能体 + 三仓定位
+python -m pasm_skills agents          # 只报告智能体从哪加载进来（排障）
+python -m pasm_skills repos           # 只打印仓库定位
+python -m pasm_skills run <name>      # 跑一个智能体
+python -m pasm_skills run --all       # 跑全部已发现的
+```
+
+退出码：`0` 全部通过 / `1` 有 FAIL / `2` 用法错误 —— 可直接用于 CI。
+
+---
+
+## 六、让自己的智能体被基座发现
+
+| 方式 | 适用 | 用法 |
+|---|---|---|
+| `PASM_SKILLS_PATH` | 本地开发最快 | 指向一个 `.py` 文件或目录 |
+| `PASM_SKILLS_AGENT_MODULES` | 显式钉死模块 | 逗号分隔的模块名 |
+| **entry points**（推荐） | 装成包后自动发现 | `[project.entry-points."pasm_skills.agents"]` |
+
+```toml
+[project.entry-points."pasm_skills.agents"]
+my-agents = "my_pkg.agents"
+```
+
+三种都失败也不会报错 —— 基座照样能 `selftest` / `list`，只是智能体数为 0。
+**基座不依赖任何智能体。**
+
+---
+
+## 七、安装
+
+```bash
+pip install pasm-skills        # 基座（零依赖，stdlib only）
+pip install -e .               # 开发模式
+pip install pasm-agents        # 想要现成智能体（依赖本基座）
+```
+
+## 八、本机配置（可选）
+
+本机"带 torch 的那个解释器"往往在仓库外，所以配置也放**仓库外**。
+在 `~/.pasm-skills/local.json` 写：
+
+```json
+{ "python": ["/path/to/python-with-torch", "%%HOME%%/venv/bin/python"] }
+```
+
+（`%%HOME%%` 是占位符；也支持 `PASM_LOCAL_CONF` 指定别的路径。）
+
+- 找得到 → 场景跑 `bionic` / `core` 档；找不到 → 自动降级 `light` 并**在每条结论里标注**
+- 建议指向**自带 site-packages 的 venv**：若环境改写了 `APPDATA`，Python 的 user site
+  packages 会指向别处，装在 user site 的 torch 就会"时有时无"
+
+优先级：`PASM_TORCH_PYTHON` → `PASM_PYTHON` → 本机配置 → 当前解释器 → 仓库内 venv → `PATH`。
+
+## 九、许可证
+
+MIT。技能包在部分平台需按平台要求标 `MIT-0`（比 MIT 更宽松，允许无署名使用）——
+本仓的 `tools/build_skill.py` 里对两种形态分别处理，详见 `docs/SKILL-FORMAT.md`。

pasm_skills-0.4.1/README.md

@@ -0,0 +1,185 @@
+# PASM Skills · 智能体基座
+
+> **本仓是基座：只提供"写智能体"的能力，不提供成品智能体。**
+> 想直接拿现成的智能体用（游戏 NPC / 老人陪伴 / 学习陪伴 / 长期验证），
+> 装独立公开仓 **pasm-agents**。
+>
+> ```bash
+> pip install pasm-skills      # 基座：SDK + 框架 + 打包工具（零依赖）
+> pip install pasm-agents      # 成品智能体集（依赖本基座）
+> ```
+
+基座给你三样东西：
+
+| | 是什么 | 入口 |
+|---|---|---|
+| **📖 使用教程** | 从"这是干什么的"到"写出并发布一个智能体"，走一遍 | **[`docs/TUTORIAL.md`](docs/TUTORIAL.md)** |
+| **SDK** | `BaseAgent` —— 记忆 / 情绪 / 动作 / 反馈 / 持久化开箱可用 | `from pasm_skills.sdk import BaseAgent` |
+| **框架** | 智能体基类与注册表、仓隔离探测、场景仿真底座、核心契约检查工具箱 | `from pasm_skills.agent import Agent, register` |
+| **打包** | 把智能体打成平台可直接上传的技能包（两种归档形态） | `from pasm_skills.build import SkillSpec, run_cli` |
+
+---
+
+## 一、30 秒写一个智能体
+
+```python
+from pasm_skills.sdk import BaseAgent
+
+class TeaHouseOwner(BaseAgent):
+    def action_pool(self):                  # 能做什么
+        return ["greet", "brew", "gossip", "rest"]
+
+    def _render_reply(self, text, facts, mood):   # 怎么回
+        tone = "蔫" if mood < -0.2 else "乐"
+        return f"（{tone}）{self.persona.get('name')}：来了您呐"
+
+a = TeaHouseOwner(agent_id="owner", persona={"name": "王掌柜", "temper": 0.6, "energy": 0.3})
+a.observe("客人夸今年的龙井好", salience=3, tags=["茶"])   # 写记忆（重要度参与淘汰）
+print(a.act())                                  # 'brew' / 'greet' / ...
+print(a.chat("生意怎么样"))                      # 走 _render_reply
+print(a.mood)                                   # 情绪（属性，不加括号）
+a.feedback("praise", action="brew")             # 显式夸"brew"这个动作 → 它会更常出现
+a.save()                                        # ~/.pasm-agents/owner/
+```
+
+跑一个完整走查（8 个环节 + 反馈塑形的实测对比）：
+
+```bash
+git clone https://gitee.com/arronzheng/pasm-skills
+cd pasm-skills
+python examples/build_your_agent.py
+python templates/agent_template.py        # 骨架自带的冒烟
+```
+
+**手把手教程**：[`docs/BUILD-AGENT.md`](docs/BUILD-AGENT.md)
+
+---
+
+## 二、基座负责什么 / 不负责什么
+
+| 基座负责 | 基座不负责 |
+|---|---|
+| ✅ 记忆写入 / 重要度淘汰 / 检索 | ❌ 具体某个智能体的人格与话术 |
+| ✅ 情绪状态与渲染（有 torch 时接真人格模块） | ❌ 具体业务逻辑（用药提醒、选题策略…） |
+| ✅ 动作选择（性格基线 + 反馈塑形） | ❌ 调用哪个大模型（**基座零 LLM 依赖**） |
+| ✅ 状态落盘与跨进程恢复 | ❌ 具体智能体的测试与验收标准 |
+| ✅ 档位检测与如实降级标注 | ❌ 替你把降级藏起来 |
+| ✅ 技能包打包（两种归档形态） | ❌ 替你上传到平台 |
+
+**基座不内置任何智能体**，这是刻意的：`python -m pasm_skills list` 在干净环境下
+会显示 0 个智能体，并提示你装一个。
+
+---
+
+## 三、档位透明（永不隐藏降级）
+
+| tier | 依赖 | 得到什么 |
+|---|---|---|
+| `light` | 无 | 纯内置：重要度淘汰 + 字面检索 + 性格/反馈加权 |
+| `core` | 能 `import pasm.cognitive`（**不需要 torch**） | 真 `memory_layers`（分层记忆）+ `learning.LearningEngine` |
+| `bionic` | 上面 + torch | 再加真情绪 / 人格模块 |
+
+**三个档位下接口完全一致** —— 调用方不写分支，但 `agent.tier` 一定会如实告诉你现在在哪一档。
+
+---
+
+## 四、目录
+
+```
+pasm-skills/
+├── pasm_skills/                 ★ 基座本体
+│   ├── sdk/                     ★ SDK：BaseAgent（写智能体从这里开始）
+│   │   └── base.py              记忆 / 情绪 / 动作 / 反馈 / 持久化 + 两个适配层
+│   ├── agent.py                 框架：Agent 基类 / AgentResult / Finding / 注册表
+│   ├── discovery.py             智能体发现（entry points / PASM_SKILLS_PATH）
+│   ├── context.py               仓隔离探测（RepoContext）
+│   ├── scenarios.py             场景仿真底座（解释器择优 / PRELUDE / 阈值判定）
+│   ├── checks.py                核心契约检查工具箱
+│   ├── build.py                 ★ 技能包打包库（两种归档形态）
+│   └── cli.py                   pasm-skills 命令行
+│
+├── templates/                   ★ 脚手架：复制就能改
+│   ├── agent_template.py        智能体骨架（自带冒烟）
+│   └── SKILL.template.body.md   技能正文模板
+│
+├── examples/                    可跑示例（不依赖任何成品智能体）
+│   └── build_your_agent.py      从零到落盘的完整走查
+│
+├── skill/                       ★ 基座自己的技能正文
+│   └── SKILL.authoring.body.md  「怎么写 PASM 智能体 + 打技能包」
+│
+├── tools/
+│   └── build_skill.py           声明本仓技能 → 调用 pasm_skills.build
+│
+└── docs/
+    ├── TUTORIAL.md              ★ 使用教程（先读这个）
+    ├── BUILD-AGENT.md           ★ 手把手：从零做一个智能体
+    ├── SKILL-FORMAT.md          ★ 技能包格式与两种归档形态
+    ├── ARCHITECTURE.md          框架分层与设计取舍
+    └── SERVER-NEEDS.md          服务器需求评估（结论：不需要）
+```
+
+---
+
+## 五、命令行
+
+```bash
+python -m pasm_skills selftest        # 自检：SDK / 框架 / 发现机制（零依赖）
+python -m pasm_skills list            # 已发现的智能体 + 三仓定位
+python -m pasm_skills agents          # 只报告智能体从哪加载进来（排障）
+python -m pasm_skills repos           # 只打印仓库定位
+python -m pasm_skills run <name>      # 跑一个智能体
+python -m pasm_skills run --all       # 跑全部已发现的
+```
+
+退出码：`0` 全部通过 / `1` 有 FAIL / `2` 用法错误 —— 可直接用于 CI。
+
+---
+
+## 六、让自己的智能体被基座发现
+
+| 方式 | 适用 | 用法 |
+|---|---|---|
+| `PASM_SKILLS_PATH` | 本地开发最快 | 指向一个 `.py` 文件或目录 |
+| `PASM_SKILLS_AGENT_MODULES` | 显式钉死模块 | 逗号分隔的模块名 |
+| **entry points**（推荐） | 装成包后自动发现 | `[project.entry-points."pasm_skills.agents"]` |
+
+```toml
+[project.entry-points."pasm_skills.agents"]
+my-agents = "my_pkg.agents"
+```
+
+三种都失败也不会报错 —— 基座照样能 `selftest` / `list`，只是智能体数为 0。
+**基座不依赖任何智能体。**
+
+---
+
+## 七、安装
+
+```bash
+pip install pasm-skills        # 基座（零依赖，stdlib only）
+pip install -e .               # 开发模式
+pip install pasm-agents        # 想要现成智能体（依赖本基座）
+```
+
+## 八、本机配置（可选）
+
+本机"带 torch 的那个解释器"往往在仓库外，所以配置也放**仓库外**。
+在 `~/.pasm-skills/local.json` 写：
+
+```json
+{ "python": ["/path/to/python-with-torch", "%%HOME%%/venv/bin/python"] }
+```
+
+（`%%HOME%%` 是占位符；也支持 `PASM_LOCAL_CONF` 指定别的路径。）
+
+- 找得到 → 场景跑 `bionic` / `core` 档；找不到 → 自动降级 `light` 并**在每条结论里标注**
+- 建议指向**自带 site-packages 的 venv**：若环境改写了 `APPDATA`，Python 的 user site
+  packages 会指向别处，装在 user site 的 torch 就会"时有时无"
+
+优先级：`PASM_TORCH_PYTHON` → `PASM_PYTHON` → 本机配置 → 当前解释器 → 仓库内 venv → `PATH`。
+
+## 九、许可证
+
+MIT。技能包在部分平台需按平台要求标 `MIT-0`（比 MIT 更宽松，允许无署名使用）——
+本仓的 `tools/build_skill.py` 里对两种形态分别处理，详见 `docs/SKILL-FORMAT.md`。

pasm_skills-0.4.1/pasm_skills/__init__.py

@@ -0,0 +1,128 @@
+"""pasm-skills —— PASM 智能体基座。
+
+**基座只提供能力，不提供具体智能体。** 它给你三样东西：
+
+1. **SDK**（`pasm_skills.sdk`）—— `BaseAgent`：观测 / 记忆 / 情绪 / 动作 / 反馈 / 持久化开箱可用，
+   写智能体的人只需要关心 persona、动作池、回复模板；
+2. **框架**（`pasm_skills.agent` / `context` / `scenarios` / `checks`）——
+   智能体基类 + 注册表、仓库隔离探测、场景仿真底座、核心契约检查工具箱；
+3. **打包**（`pasm_skills.build`）—— 把智能体打成平台可直接上传的技能包（两种归档形态）。
+
+三分钟上手：
+
+    python -m pasm_skills selftest            # 自检（零依赖，随时可跑）
+    python -m pasm_skills list                # 看已发现的智能体 + 三仓定位
+
+具体智能体由外部包提供（本基座**不内置**），发现方式见 `pasm_skills.discovery`：
+entry points 组 `pasm_skills.agents`，或 `PASM_SKILLS_PATH` / `PASM_SKILLS_AGENT_MODULES`。
+官方智能体集在独立公开仓 **pasm-agents**（NPC / 老人陪伴 / 学习陪伴 / 长期验证）。
+
+零依赖：只用标准库，不需要 torch / 不需要 API key / 不需要服务器。
+"""
+from __future__ import annotations
+
+__version__ = "0.4.1"
+
+from .agent import (  # noqa: F401
+    AGENTS, FAIL, HOOKS, OK, SKIP, WARN,
+    Agent, AgentResult, Finding,
+    agent, catalog, names, register, run_agent,
+)
+from . import discovery  # noqa: F401  智能体发现（entry points / 环境变量）
+from . import scenarios  # noqa: F401  领域场景仿真底座（PRELUDE / 解释器择优 / 指标判定）
+from . import sdk  # noqa: F401  产品智能体 SDK（BaseAgent）
+from .context import REPO_SPEC, RepoContext  # noqa: F401
+
+__all__ = [
+    "__version__", "selftest",
+    "Agent", "AgentResult", "Finding", "AGENTS", "HOOKS",
+    "OK", "WARN", "FAIL", "SKIP",
+    "agent", "catalog", "names", "register", "run_agent",
+    "RepoContext", "REPO_SPEC", "scenarios", "sdk", "discovery",
+]
+
+
+def selftest() -> bool:
+    """框架自检：不依赖任何 PASM 仓、也不依赖任何具体智能体，纯本地可跑。"""
+    ok = True
+
+    def check(cond: bool, msg: str) -> None:
+        nonlocal ok
+        if not cond:
+            ok = False
+            print("  x %s" % msg)
+        else:
+            print("  v %s" % msg)
+
+    print("pasm-skills selftest v%s（基座）" % __version__)
+
+    # 结论对象
+    check(Finding(OK, "t").line().startswith("[OK]"), "Finding.line 带等级标签")
+    r = AgentResult(agent="a", ok=True,
+                    findings=[Finding(OK, "1"), Finding(FAIL, "2")])
+    check(r.counts()[FAIL] == 1 and r.worst() == FAIL, "AgentResult 统计与最差等级正确")
+    check(r.to_dict()["worst"] == FAIL, "AgentResult.to_dict 可序列化")
+
+    # 智能体与注册表（基座不再内置智能体，这里现造一个）
+    class _T(Agent):
+        name = "_selftest_agent"
+        goal = "自检用"
+
+        def run(self):
+            self.ok("收集一条结论")
+
+    register(_T)
+    check("_selftest_agent" in names(), "注册表能登记自定义智能体")
+    check(agent("_selftest_agent") is _T, "按名字取回正确类")
+
+    class _Boom(Agent):
+        name = "_selftest_boom"
+        goal = "抛异常也要被兜住"
+
+        def run(self):
+            raise RuntimeError("boom")
+
+    register(_Boom)
+    res = _Boom().execute()
+    check(res.worst() == FAIL and "boom" in res.error, "run() 异常被兜住并计为 FAIL")
+
+    # 智能体发现：没有任何外部智能体时也必须安静地成功
+    try:
+        loaded, _warns = discovery.load_agents()
+        check(isinstance(loaded, list), "智能体发现机制可用（无外部智能体也不报错）")
+    except Exception as ex:                          # noqa: BLE001
+        check(False, "智能体发现机制可用（异常：%s）" % ex)
+
+    # SDK：不依赖 PASM 核心也能建、能记、能选动作、能落盘
+    import tempfile
+    try:
+        from .sdk import BaseAgent
+        with tempfile.TemporaryDirectory() as td:
+            class _A(BaseAgent):
+                def action_pool(self):
+                    return ["a1", "a2"]
+
+                def _render_reply(self, text, facts, mood):
+                    return "ok:%s" % text
+
+            a = _A(agent_id="_selftest_sdk", persona={"name": "自检"}, persist_dir=td)
+            a.observe("第一条记忆", salience=3)
+            check(a.act() in ("a1", "a2"), "SDK：act() 从动作池里选")
+            check(a.chat("hi").startswith("ok:"), "SDK：chat() 走 _render_reply")
+            check(a.mood.__class__ is float, "SDK：mood 是 float 属性（不是方法）")
+            check(isinstance(a.feedback("praise", action="a1"), dict), "SDK：feedback 返回权重字典")
+            check(a.tier in ("light", "core", "bionic"), "SDK：tier 标注当前档位")
+            a.save()
+            check((a.persist_dir / "agent_state.json").exists(), "SDK：save() 落盘")
+    except Exception as ex:                          # noqa: BLE001
+        check(False, "SDK：建/记/选/存全链路可跑（异常：%s）" % ex)
+
+    # 上下文
+    ctx = RepoContext(roots=[])
+    check(isinstance(ctx.describe(), dict), "RepoContext 可描述三仓定位")
+    check(ctx.has() is True, "空 needs 视为满足")
+
+    AGENTS.pop("_selftest_agent", None)
+    AGENTS.pop("_selftest_boom", None)
+    print("pasm-skills selftest:", "通过" if ok else "失败")
+    return ok

pasm_skills-0.4.1/pasm_skills/__main__.py

@@ -0,0 +1,5 @@
+"""`python -m pasm_skills` 入口。"""
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())