Secretary Cold Skills 仓库

Secretary 的用户级**冷技能（ColdSkill）**库。冷技能 = 由规则引擎执行的确定性能力单元，0 token、LLM 永不接触。由 Secretary 的"候选挖掘 → 采纳/撤销"命令自动生成与维护，也可人工编写。

目录布局

/cold-skills/
  <skill-id>/            # 一个冷技能 = 一个目录
    skill.json           # manifest（自描述：id/mode/keywords/description/...）
    script.py            # 仅 script 模式
    test_script.py       # 仅 script 模式（必须）

技能三模式

模式	形态	触发	测试要求
literal	仅 manifest + 内嵌 replies	关键词精确全等 → 固定文案	免测试
attach	仅 manifest，target + 追加关键词	关键词 → 已有核心意图 handler	免测试
script	manifest + script.py（`run(ctx) -> str	None`）	任意触发词 → 确定性逻辑

manifest 最小示例（literal）

{
  "id": "cxo-faq",
  "version": 1,
  "description": "CXO与QDII关系问答",
  "keywords": ["CXO是什么", "qdii和cxo的关系"],
  "mode": "literal",
  "replies": ["CXO指代医药研发外包…"],
  "enabled": true,
  "tags": ["财富", "faq"]
}

环境变量约定

• SECRETARY_COLD_SKILLS_DIR：本仓库克隆目录。Secretary 的 ColdSkillLoader 从该路径热加载技能（默认 /root/git/secretary-cold-skills）。未设置或路径缺失时冷技能层静默禁用。

暂存与版本管理

• 每一次"采纳建议/撤销技能"都是一次 git commit + push。
• 双远端：origin(Forgejo 主) + github(备份)。