xb-configlisted
Install: claude install-skill dennydkt/xbskill
# xb-config:使用偏好配置
直调时先读取 `../xbskill/references/contracts.md`、`../xbskill/references/resolution-standard.md` 与 `../xbskill/references/specialist-rewrite-method.md`;缺文件时报精确路径并停止受影响步骤。配置字段、状态机与脚本接口见 `references/config-contract.md`,缺失时停止配置。用户明确进入配置可越过尚未初始化的调用门。用户仅请求配置时只完成配置;由已明确调用的 XB 任务因缺配置转入时,记录原任务和授权,选齐后立即恢复该任务,无需用户重新输入。用户同时撤销或更换任务时按新指令处理。
## 目标与边界
让使用者决定 XB 何时参与,以及是否主动提示保存。产物为两项明确选择、作用域和可核对回执。安装成功只代表文件就位;用户完成两项选择后,配置才生效。
配置问题可能来自尚未选择、读取了另一个项目、文件损坏、旧记忆偏好残留,或宿主绕过调用门。先核对配置位置、两项值和触发原话,避免把所有误调用归因于强度选择。只询问会改变当前分支的缺项;不替用户选推荐档位,不把沉默当同意,不从职业、熟练度或历史偏好猜测。
## 初始化与修改
1. 确定当前项目根目录,告知偏好只适用于该项目。运行 `scripts/config_manager.py read --project <项目绝对路径>`。缺文件或缺选项显示“未配置”,禁止创建默认实例。读取失败显示错误与路径,停止使用该配置,禁止自动恢复默认值。
2. 先读取 `references/configuration-guide.md`,只展示“默认展示短版”,每个档位用一句话解释实际行为,再请用户自行选择。完整初始化不超过 450 字符(实际路径除外),不默认展示逐档案例、适用人群或详细边界;用户追问后只展开对应部分。可以一次回答“调用中,保存低”。没有默认已选项,用户只选一项时保留其会话内选择,继续询问另一项;不得提前持久化。用户明确拒绝配置时保留未配置状态,停止 XB 工作流。用户已经明确给出两项时直接采用原话,免于重复选择。
选项名称固定为“高:自动参与”“中:先问再参与”“低:点名才参与”,以及“高:每次回复提醒”“低:需要时自己保存”。短版与详细解释以配置指南为唯一来源;指南缺失时报精确路径,停止初始化展示,不退回只有标签的选项。
3. 两项齐全后,以用户的明确选择作为本次配置写入授权,调用 `set`,原子写入 `<项目>/.xbskill/config.json`。修改时保留用户未要求修改的有效选项;原配置未完成时仍须补齐。禁止迁移旧 `auto_checkpoint`、`ask` 或其他记忆模式作为本次选择。
4. 回读文件,简短交付两项选择、生效位置与作用域;写入失败报错,禁止声称已保存。无法确定项目时仅在当前会话暂存两项,明确“本次会话有效,尚未跨会话保存”;待用户指定项目后再持久化,禁止静默写到当前工具目录、用户目录或任意工作目录。
5. 用户可随时再次调用 `xb-config` 修改两项。配置写入只存偏好;会话、人物、公司和敏感信息继续走既有保存授权流程。
## 调用门与用户选择
- 每次 XB 尝试进入任务前读取有效配置并执行调用门;未配置时只允许用户显式进入主入口或配置引导,普通自然语言不得接管。
- 用户指定外部技能、明确拒绝或退出 XB 时,所有强度均让出控制权;不