speclite-customize

name	speclite-customize
description	为已安装的 SpecLite skill 编写或更新 customize.toml 覆盖配置。用于用户要求 customize speclite、override skill、调整 agent 行为或定制 workflow。核心能力：发现可配置项、生成稀疏 TOML、验证合并结果。
allowed-tools	Read, Write, Bash, Grep, Glob
metadata	{"version":"1.0.0","author":"fancyliu","catalog":"speclite"}

[技能说明] Speclite Customize 将用户意图转换为 {speclite-runtime-root}/custom/ 下正确放置的 TOML override。它支持探索可定制 Skill、选择 agent/workflow surface、生成稀疏 override、写入 team 或 user 文件，并验证合并结果。

[核心能力] - 预检安装：确认 {project-root}/_speclite/ 和 runtime 脚本是否存在。 - 可定制项发现：运行 scripts/list_customizable_skills.py 扫描安装 Skill 的 customize.toml。 - surface 判断：区分 [agent]、[workflow] 或双 surface，帮助用户选择正确覆盖面。 - 稀疏 TOML 生成：只写用户要改变的字段，不复制完整 customize.toml。 - team/user 放置：将团队覆盖写入 {speclite-runtime-root}/custom/{skill-name}.toml，个人覆盖写入 {skill-name}.user.toml。 - 合并验证：优先使用 resolver，失败时按 base -> team -> user 手动解释合并结果。

[执行流程] 1. 预检 {project-root}/_speclite/；缺失时说明 Speclite 未安装并停止。 2. 运行 speclite resolve config --project-root {project-root} 获取 merged runtime config 中的 user_name 和 communication_language。 3. 分类用户意图：directed、exploratory、audit/iterate 或 cross-cutting。 4. exploratory 或 audit 场景运行 python3 {skill-root}/scripts/list_customizable_skills.py --project-root {project-root}，必要时追加 --extra-root。 5. 读取目标 Skill 的 customize.toml 和已存在覆盖文件，判断应修改 agent surface、workflow surface 或多个 workflow。 6. 生成稀疏 TOML，先展示完整内容和 diff，等待用户明确确认。 7. 写入 {speclite-runtime-root}/custom/ 下 team 或 user 覆盖文件。 8. 运行 speclite resolve customization --skill <install-path> --project-root {project-root} --key <agent-or-workflow> 验证；失败时手动合并并解释。 9. 总结写入位置、变更字段和后续迭代方式。

[注意事项] - {speclite-runtime-root} = {project-root}/_speclite。 - 中央 config 覆盖不属于 per-skill customize，需明确说明边界。 - 如果目标 customize.toml 没暴露用户想改的字段，必须如实说明，不得发明字段。 - Override 必须稀疏，只包含用户确认的字段。 - 写文件前必须展示内容并获得明确确认。