SKILLS_GUIDANCE = (
    "After completing a complex task (5+ tool calls), fixing a tricky error, "
    "or discovering a non-trivial workflow, save the approach as a "
    "skill with skill_manage so you can reuse it next time.\n"
    "When using a skill and finding it outdated, incomplete, or wrong, "
    "patch it immediately with skill_manage(action='patch') — don't wait to be asked. "
    "Skills that aren't maintained become liabilities."
)

def atomic_write_text(file_path, content, encoding="utf-8"):
    fd, temp_path = tempfile.mkstemp(dir=str(file_path.parent))
    try:
        with os.fdopen(fd, "w", encoding=encoding) as f:
            f.write(content)
        os.replace(temp_path, file_path)
    except Exception:
        os.unlink(temp_path)
        raise

SKILLS_PROMPT_CACHE_MAX = 8
SKILLS_PROMPT_CACHE = OrderedDict()

def _skill_should_show(conditions, available_tools, available_toolsets):
    # fallback_for: 当主工具可用时，隐藏这个fallback skill
    for ts in conditions.get("fallback_for_toolsets", []):
        if ts in available_toolsets:
            return False
    # requires: 当依赖工具不可用时，隐藏这个skill
    for t in conditions.get("requires_tools", []):
        if t not in available_tools:
            return False
    return True

"If a skill you loaded was missing steps, had wrong commands, or needed
 pitfalls you discovered, update it before finishing."

from tools.fuzzy_match import fuzzy_find_and_replace
new_content, match_count, strategy, match_error = fuzzy_find_and_replace(
    content, old_string, new_string, replace_all
)