SOTA on Chang Luo

Skill Zoo：一站式 Agent 技能管理工具

Sun, 24 May 2026 00:00:00 +0000

给所有流浪的技能宝宝一个家

GitHub 项目地址：skill-zoo

自 Coding Agent 爆火以来，Agent 技能作为其能力的重要载体也备受关注。Agent 技能本质上是文档，但凭借其可插拔、任务间通用和渐进式披露等特性，已经变成了 prompt 的一种独特存在形式。

Agent 技能尤其擅长有套路、有 SOP、需要风格迁移的任务，比如网页设计、数据分析、制作幻灯片等。下面是我用 ThariqS 佬开源的 HTML 模板做的 Slide。

这个 Slide 偏简洁风，如果你喜欢其它风格，可以上 GitHub 搜索相关 skill。

一、如何管理技能

Agent 技能良莠不齐，下载下来用不用得上另说，上下文总归被占用了。如果技能数量太多，技能列表甚至会被截断。

因此，技能是需要管理的：不用的要删除，过时的要更新。同时技能管理又是一件挺主观的事，哪些技能有用，哪些技能质量高，需要我们主动判断。阅读方便就变成一个很重要的指标。npx skills 这种 CLI 不方便阅读，需要一个 App 来提供阅读和管理功能。

Skill Zoo 就打算做好这件事。它提供了一系列随点随用的功能，帮我们降低技能管理成本，拉近我们和技能之间的距离。

项目地址：luochang.ink/skill-zoo

二、产品设计

为了达成这个目标，我开发了覆盖 Agent Skills 整个生命周期的管理功能。

2.1 SSOT 模式

为解决 Agent 技能跨编程工具复用的问题，Skill Zoo 采用 唯一真实源（SSOT）+ 软链接 的方法，将已有技能链接至其他编程工具的 Skill 目录使用。

SSOT 是什么？Claude Code 和 Codex 都有技能文件夹。如果一个技能分别存放在不同的技能文件夹里，会造成技能重复存放、技能版本不可控等问题。SSOT 就是维护唯一的技能文件夹，统一管理技能。

新瓶装旧酒：纸牌魔术 MCP

Sat, 12 Jul 2025 00:00:00 +0000

Chico 和 Dico 是两名魔术师，他们有一个经典纸牌魔术：抽五张扑克牌，根据前四张，猜第五张是什么。完成这个魔术不需要任何魔术师的技巧，它完全建立在数学原理之上。只需要一点数学知识和充分的练习，你也能表演这个魔术。

GitHub 项目地址：card-magic-mcp

五年前，我写了一篇文章《用魔法打败魔法》，介绍 Chico & Dico 魔术的数学原理，并用 Python 实现了这个魔术。随着时代的发展、科技的进步，今天我们有更简单的方法来玩这个魔术，不需要运行 Python，不需要看懂公式，只需要打开 ModelScope 和大模型对话，就可以轻松体验这个魔术↓↓↓

访问 ModelScope Playground: card-magic-mcp

下面我将介绍这个魔术的数学原理和算法实现，然后讲解如何用 FastMCP 将魔术流程包装成大语言模型可以调用的工具（MCP Server）。

Chico & Dico 的魔术

Chico 和 Dico 是两位魔术师，他们经常表演的一个魔术是这样的：Chico 将一副 52 张的扑克牌交给观众，让他抽取其中的 5 张。然后 Chico 将这 5 张牌按一定的顺序重新排列，再将其还给观众。上述整个过程 Dico 都是看不见的。然而，当观众按 Chico 排好的顺序依次展示前四张牌之后，Dico 却能准确地说出第五张牌是什么。

乍一看这个魔术很神奇。随机抽取 5 张牌，你能从前 4 张牌中看出第 5 张牌是什么吗？对于普通人来说，当然不行。Chico 和 Dico 的秘诀在于 Chico 有机会将扑克重新排序。如果两人事先约定好某种协议，Chico 有可能通过前四张扑克排列的顺序，向 Dico 传递关于第 5 张牌的信息。

关键在于如何实现这种协议。

数学原理

在进行分析之前，我们需要把 Chico & Dico 的魔术抽象成一个数学模型。

魔术本身已经提供了一些建模信息。假设一共有 \( n \) 张牌，抽取其中的 \( k \) 张。在对牌进行某种排序之后，我们需要利用前 \( (k - j) \) 张牌的信息，推测后 \( j \) 张牌是什么。

摸鱼侠极客版

Sun, 03 Jul 2022 00:00:00 +0000

老板：退退退

GitHub 项目地址：moyu-bash

1. 缘起

最近刷到一个微信小程序，叫 “摸鱼侠”，它长这样：

这里面有个栏目叫 “今日已摸到”，还挺有意思的，它会计算今日截至当前为止挣到的工资。

我寻思这小程序颜色太过艳丽，容易被老板抓包，便计上心来，打算写个 bash 版摸鱼侠。和生产环境融为一体，纯键盘操控，老板来了一个 ctrl c 便能毁尸灭迹，大大滴方便。

2. 出生

这要实现起来也不难，只要把 (工作秒数 - 休息秒数) * 每秒工资 就好嘛。

我纯纯的 bash 新手，不对之处大家批评。

# Author: github@luochang212

work_start=10:00:00    # 上班时间
lunch_start=12:00:00    # 午饭开始
lunch_end=13:00:00    # 午饭结束
dinner_start=18:00:00    # 晚饭开始
dinner_end=19:00:00    # 晚饭结束
work_end=20:00:00    # 下班时间
salary=40000    # 月薪
day=22    # 每月工作天数


CURRENT_TIME=\( (date +"%T")
EMOJI_ARRAY=("(・▽ < )★" "─=≡Σ((( つ•̀ 3 •́)つ" "┗|｀O′|┛" "_(┐「ε:)_" "ヽ( ˘ω˘ )ゝ")

get_second() {
    read -r h m s <<<  \)(echo \( 1 | tr ':' ' ')
    echo  \)(((10#\( h*60*60)+(10# \)m*60)+10#\( s))
}

calc_duration() {
    local start= \)(get_second \( 1)
    local end= \)(get_second \( 2)
    echo  \)((end-start))
}

calc_work_time() {
    local lunch_time=\( (calc_duration  \)lunch_start \( lunch_end)
    local dinner_time= \)(calc_duration \( dinner_start  \)dinner_end)
    if [ \( (calc_duration  \)CURRENT_TIME \( work_start) -gt 0 ]; then
        echo 0
    elif [  \)(calc_duration \( CURRENT_TIME  \)lunch_start) -gt 0 ]; then
        echo \( (calc_duration  \)work_start \( CURRENT_TIME)
    elif [  \)(calc_duration \( CURRENT_TIME  \)lunch_end) -gt 0 ]; then
        echo \( (calc_duration  \)work_start \( lunch_start)
    elif [  \)(calc_duration \( CURRENT_TIME  \)dinner_start) -gt 0 ]; then
        echo \( (( \)(calc_duration \( work_start  \)CURRENT_TIME) - lunch_time))
    elif [ \( (calc_duration  \)CURRENT_TIME \( dinner_end) -gt 0 ]; then
        echo  \)((\( (calc_duration  \)work_start \( dinner_start) - lunch_time))
    elif [  \)(calc_duration \( CURRENT_TIME  \)work_end) -gt 0 ]; then
        echo \( (( \)(calc_duration \( work_start  \)CURRENT_TIME) - lunch_time - dinner_time))
    else
        echo \( (( \)(calc_duration \( work_start  \)work_end) - lunch_time - dinner_time))
    fi
}

show_work_time() {
    local work_sec=\( (calc_work_time)
    echo " \)((\( work_sec / 3600)) hours and  \)((\( work_sec % 3600 / 60)) minutes and  \)((\( work_sec % 60)) seconds"
}

calc_money() {
    local lunch_time= \)(calc_duration \( lunch_start  \)lunch_end)
    local dinner_time=\( (calc_duration  \)dinner_start \( dinner_end)
    local mnt= \)(((\( (calc_duration  \)work_start \( work_end) - lunch_time - dinner_time) / 60))
    local salary_per_mnt= \)((\( salary * 100000000 /  \)day / \( mnt))
    local work_sec= \)(calc_work_time)
    local money=\( ((salary_per_mnt * (work_sec / 60) / 1000000))
    echo  \)money
}

show_money() {
    local money=\( (calc_money)
    echo "已挣到： \)((\( money / 100)). \)((\( money % 100)) 元"
}

calc_work_end() {
    if [  \)(calc_duration \( CURRENT_TIME  \)work_start) -gt 0 ]; then
        echo "距离下班还有：[还没开始上班]"
    elif [ \( (calc_duration  \)CURRENT_TIME \( work_end) -gt 0 ]; then
        local time_left= \)(calc_duration \( CURRENT_TIME  \)work_end)
        echo "距离下班还有：\( (( \)time_left / 3600)) 小时 \( (( \)time_left % 3600 / 60)) 分钟 \( (( \)time_left % 60)) 秒"
    else
        echo "距离下班还有：[下班啦]"
    fi
}

random_emoji() {
    local len=\( {#EMOJI_ARRAY[*]}
    echo  \){EMOJI_ARRAY[RANDOM % $len]}
}


random_emoji
show_money
calc_work_end

Note: 为了让界面可爱一点，我用颜文字润色了一下！

用魔法打败魔法！

Fri, 21 Feb 2020 00:00:00 +0000

Chico 和 Dico 是两位魔术师，他们有一个经典魔术：根据任意四张牌猜第五张牌。但完成这个魔术并不需要任何魔术师的技巧，因为它完全建立在数学原理之上。只需要一点数学知识和充分的练习，你也能表演这个魔术！

GitHub 项目地址：chico-and-dico

Chico 和 Dico 的魔术

Chico 和 Dico 是两位魔术师，他们经常表演的一个魔术是这样的：Chico 将一副 52 张的扑克牌交给一位观众，让他随机抽取其中的 5 张。然后 Chico 将这 5 张牌按一定的顺序重新排列，再将其还给观众。上述整个过程 Dico 都是看不见的。然而，当观众按 Chico 排好的顺序依次展示前四张牌之后，Dico 却能准确地说出第五张牌是什么。

乍一看这个魔术很神奇。随机抽取 5 张牌，你能从前 4 张牌中看出第 5 张牌是什么吗？对于普通人来说，当然不可能。Chico 和 Dico 的秘诀在于 Chico 有机会将扑克重新排序。如果两人事先约定好某种协议，Chico 是有可能通过扑克排列的顺序，向 Dico 传递关于第 5 张牌的信息的。

关键在于如何实现这种协议。

数学模型

在进行分析之前，我们需要把 Chico 和 Dico 的魔术抽象成一个数学模型。

魔术本身已经提供了一些建模信息。我们可以假设一共有 n 张牌，抽取其中的 k 张。在对牌组进行某种排序之后，我们需要利用前 (k - j) 张牌的信息，推测后 j 张牌是什么。

现在我们有 n, j, k 三个变量，下面我们来进一步探究三个变量之间究竟服从何种关系。

【项目】TSP旅行路线规划

Wed, 10 Apr 2019 00:00:00 +0000

GitHub 项目地址：tsp-route

对于在欧洲的小伙伴们，复活节假在这一周就正式开始啦。大家都是怎么计划旅行的呢？

我的习惯是在出发前最后一晚，花上半小时，搜索目的地景点 (Point of interest, POI), 然后在Google Maps上为它们点上小星星，以免和它们擦肩而过。我的地图经过一番操作，就成了下面这副模样。

此时此刻，望着这些密集的星星，我不禁自问：如何才能走最少的路，遍历所有景点呢?

搜索了谷歌和百度，都没找到我要路径规划功能。最接近需求的是谷歌地图的"Add destination"功能。然而这个功能只是依次连接你点选的地点。并不能由一组地点，确定连接它们的一条全局最短路径。

没有现成应用怎么办，我打算自己动手写一个。

下图是Google Add destination功能。

适用模型：TSP 模型

用一句话概括需求就是：我们需要一条从某地方出发，遍历所有地点，最终回到起点的最短路径。

这个需求其实就是运筹学的一个经典问题，旅行商问题(TSP)。旅行商问题的确切描述是这样的：一个商人在各个城市之间旅行，要求遍历所有城市并返回到出发点，要如何规划路线，才能使总路径最短。（打开维基百科了解更多)

解决思路

用googlemaps包获取纬度和经度信息
用OR-Tools包求解TSP问题
最后用gmaps可视化结果

在敲代码的过程中，最难的地方莫过于看文档查API, 搞清楚输入输出和调用结构。不过敲完这一顿之后我还是不禁感慨，Google 太为开发者着想了。一旦学会调用API，实现一个简单应用的代码量还是很小的 orz

食用指南

项目地址 –> 传送门

在运行代码之前，你需要以下配置：

一个Jupyter Notebook.
你需要安装这些包：googleplaces, googlemaps, gmaps, ortools.
你需要一个Google Maps API key, 从这里获取API.

完成配置等于成功的一半。在Jupyter notebook打开TSPSolver.ipynb，将第二个代码块的所有变量，改成自己的，比如自己的目的地自己的区域和自己的API密码……最后从头到尾运行所有代码块，你就可以得到自己的定制路线辣~

配置代码如下。

# input the places of interest (POI)
places = 'YHA London Central Hostel', 'Coca-Cola London Eye', 'St. Paul\'s Cathedral', 'Leadenhall Market', 'The National Gallery' \
          'Big Ben', 'Buckingham Palace', 'Waterloo Station'

# the region
Location='London'

# choose a mode
Mode = "walking"  # "driving", "walking", "bicycling", "transit"

# get Google API key from following website: 
# https://developers.google.com/maps/documentation/distance-matrix/start#get-a-key
password = "YOUR_GOOGLE_API_KEY_HERE"

欢迎Star, Pull, Pr.