@winspan/claude-forge 8.51.1 → 8.53.2

package/dist/skills/upgrade-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-engine.js","sourceRoot":"","sources":["../../src/skills/upgrade-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAY,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAuClC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAyC;IACnE,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,gDAAgD,EAAE;IAC/E,EAAE,IAAI,EAAE,aAAa,EAAG,GAAG,EAAE,yCAAyC,EAAE;CACzE,CAAC;AAEF,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,kBAAkB,CAAC,QAAgB,EAAE,UAAkB;IAC9D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;QAChE,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;QAClE,MAAM,WAAW,GAAG,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAEjF,MAAM,WAAW,GAAY,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC;QACxD,MAAM,QAAQ,GAAa,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YACnD,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YAC/D,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,EAAE;YACF,MAAM,EAAE,UAAU;YAClB,QAAQ;YACR,IAAI;YACJ,WAAW;YACX,QAAQ;YACR,OAAO,EAAE,GAAG;SACb,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,WAAW,CAAC,GAAW;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,UAAU,IAAI,CAAC,OAAe;QACjC,IAAI,OAAmC,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,iEAAiE;gBACjE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAChD,IAAI,CAAC;oBACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBACzB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,iEAAiE;oBACjE,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACtF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA6C,EAC7C,aAAqB;IAErB,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnD,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAExD,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAE5B,qEAAqE;QACrE,IAAI,CAAC;YACH,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;gBACnD,MAAM,SAAS,CAAC,WAAW,SAAS,kBAAkB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/E,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;gBACnD,MAAM,SAAS,CAAC,wBAAwB,MAAM,CAAC,GAAG,MAAM,SAAS,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,2CAA2C,GAAG,EAAE,CAAC,CAAC;YACxF,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,4BAA4B,GAAG,EAAE,CAAC,CAAC;gBACvE,SAAS;YACX,CAAC;QACH,CAAC;QAED,yFAAyF;QACzF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;YAC7C,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;gBAC/B,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC5D,IAAI,SAAS,EAAE,CAAC;oBACd,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,kBAAkB,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAyB,EACzB,cAA+B;IAE/B,uDAAuD;IACvD,SAAS,QAAQ,CAAC,IAAY;QAC5B,OAAO,IAAI,GAAG,CACZ,IAAI;aACD,WAAW,EAAE;aACb,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;aAChC,KAAK,CAAC,QAAQ,CAAC;aACf,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAC/B,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,SAAS,YAAY,CAAC,IAAiB,EAAE,IAAiB;QACxD,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACjD,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,YAAY,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,sBAAsB,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,MAAM,mBAAmB,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAEnF,IAAI,IAAI,GAAuB,IAAI,CAAC;IAEpC,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;QACtC,MAAM,qBAAqB,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACpE,MAAM,kBAAkB,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;QAEhF,2EAA2E;QAC3E,MAAM,YAAY,GAAG,YAAY,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,YAAY,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;QACxE,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,GAAG,SAAS,GAAG,GAAG,CAAC,CAAC;QAEhE,+EAA+E;QAC/E,yEAAyE;QACzE,MAAM,aAAa,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,SAAS,CAAC,IAAI,GAAG,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QACxG,MAAM,YAAY,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAChF,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3D,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAClC,MAAM;YACR,CAAC;QACH,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1D,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAClC,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBACnC,IAAI,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAyB,EACzB,QAAuB,EACvB,UAA0B;IAE1B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEpE,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE;YACpC,MAAM;YACN,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,MAAM;YACjB,UAAU,EAAE,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO;YACL,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,YAAY,GAAG,EAAE;YAC5B,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;IAED,uDAAuD;IACvD,MAAM,QAAQ,GAAG,GAAG;SACjB,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,IAAI,EAAE,CAAC;IAEV,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA4B,CAAC;QAE/D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;YACjF,CAAC,CAAE,MAAM,CAAC,MAAwB;YAClC,CAAC,CAAC,MAAM,CAAC;QAEX,MAAM,UAAU,GACd,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;YACnC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC,CAAC;QAER,MAAM,SAAS,GACb,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAE/D,MAAM,cAAc,GAClB,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;QAE3E,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,mCAAmC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YACtE,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAsB,EACtB,UAAkB,EAClB,KAA4D;IAE5D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEnE,MAAM,YAAY,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAClF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;YAC7B,YAAY,CAAC,CAAC,CAAC,MAAmC,CAAC,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,wBAAwB;QACxB,EAAE;QACF,cAAc,SAAS,EAAE;QACzB,EAAE;QACF,YAAY;QACZ,EAAE;QACF,oBAAoB;QACpB,oBAAoB;QACpB,0BAA0B,KAAK,CAAC,KAAK,IAAI;QACzC,2BAA2B,KAAK,CAAC,OAAO,IAAI;QAC5C,uBAAuB,YAAY,CAAC,OAAO,IAAI;QAC/C,qBAAqB,YAAY,CAAC,KAAK,IAAI;QAC3C,oBAAoB,YAAY,CAAC,IAAI,IAAI;QACzC,oBAAoB,YAAY,CAAC,YAAY,IAAI;QACjD,aAAa,YAAY,CAAC,KAAK,IAAI;QACnC,iBAAiB,KAAK,CAAC,SAAS,IAAI;QACpC,EAAE;QACF,wBAAwB;QACxB,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,sBAAsB,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAElD,6CAA6C;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,UAAU,MAAM,KAAK,CAAC,iBAAiB,MAAM,KAAK,CAAC,MAAM,MAAM,CAAC,CAAC;QAEzG,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,CAAC,IAAI,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB,EAClB,WAAmB,EACnB,aAAqB;IAErB,qCAAqC;IACrC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,2BAA2B,WAAW,GAAG,CAAC,CAAC;QAC9E,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,4BAA4B,WAAW,+CAA+C,MAAM,EAAE,CAC/F,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iFAAiF;QACjF,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAAE,MAAM,GAAG,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,wDAAwD,GAAG,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,yCAAyC;IACzC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE;SAClB,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;SACjB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,4CAA4C;IAC7D,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE;QACxB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACnD,OAAO,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;IACxC,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACvD,mCAAmC;IACnC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5B,qCAAqC;YACrC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,WAAW,IAAI,MAAM,EAAE,CAAC,CAAC;YAClE,MAAM,EAAE,CAAC;QACX,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,+BAA+B;QACxC,CAAC;IACH,CAAC;IACD,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,kDAAkD;IAClD,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACvF,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,uBAAuB,aAAa,CAAC,MAAM,aAAa,UAAU,EAAE,CAAC,CAAC;IAElF,kBAAkB;IAClB,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAE7D,2DAA2D;IAC3D,MAAM,YAAY,GAAG,kDAAkD,CAAC;IACxE,IAAI,KAA6B,CAAC;IAElC,MAAM,OAAO,GAAyE,EAAE,CAAC;IACzF,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC;YACX,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YAC3B,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YAC9B,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAC9B,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnD,2DAA2D;IAC3D,MAAM,aAAa,GACjB,gIAAgI,CAAC;IACnI,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5D,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YAC3F,OAAO,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,UAAU,KAAK,CAAC,CAAC;QAEpE,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,8BAA8B;gBAC9B,MAAM,gBAAgB,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;gBACzE,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;gBAC1D,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC,8BAA8B,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YAChE,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBACpC,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC7D,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;oBACvD,OAAO,EAAE,CAAC;oBACV,MAAM,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC9D,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,yBAAyB,KAAK,CAAC,UAAU,kCAAkC,CAAC,CAAC;oBACzF,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,CAAC,KAAK,CAAC,6BAA6B,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC,CAAC;YACtE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,6BAA6B,OAAO,aAAa,OAAO,UAAU,CAAC,CAAC;IAChF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC"}

package/dist/skills/upgrade-prompt.d.ts

@@ -0,0 +1,20 @@
+/**
+ * upgrade-prompt.ts
+ *
+ * Builds the system + user prompts for AI-assisted skill evaluation.
+ * Pure functions — no I/O, no side effects.
+ */
+import type { CandidateSkill } from './upgrade-engine.js';
+import type { OfficialSkill } from './official-skills.js';
+/**
+ * Build system + user prompts for evaluating whether a candidate skill should
+ * upgrade, merge with, or skip an official skill.
+ *
+ * The system prompt defines the decision criteria and output JSON contract.
+ * The user prompt contains the two skill bodies (capped at 2000 chars each).
+ */
+export declare function buildEvaluationPrompt(candidate: CandidateSkill, official: OfficialSkill): {
+    system: string;
+    user: string;
+};
+//# sourceMappingURL=upgrade-prompt.d.ts.map

package/dist/skills/upgrade-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-prompt.d.ts","sourceRoot":"","sources":["../../src/skills/upgrade-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAa1D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,aAAa,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAoDlC"}

package/dist/skills/upgrade-prompt.js

@@ -0,0 +1,75 @@
+/**
+ * upgrade-prompt.ts
+ *
+ * Builds the system + user prompts for AI-assisted skill evaluation.
+ * Pure functions — no I/O, no side effects.
+ */
+const MAX_CONTENT_CHARS = 2000;
+/**
+ * Truncate content to at most `maxChars` characters, appending an ellipsis
+ * marker so the model knows the text was cut.
+ */
+function truncate(text, maxChars = MAX_CONTENT_CHARS) {
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars) + '\n\n...[content truncated]';
+}
+/**
+ * Build system + user prompts for evaluating whether a candidate skill should
+ * upgrade, merge with, or skip an official skill.
+ *
+ * The system prompt defines the decision criteria and output JSON contract.
+ * The user prompt contains the two skill bodies (capped at 2000 chars each).
+ */
+export function buildEvaluationPrompt(candidate, official) {
+    const system = `你是 Claude Code skill 内容评估专家。
+
+你的任务是比较"候选 skill"和"官方 skill"，决定如何处理。
+
+## 评估维度
+- **主题重叠度**：两个 skill 覆盖的领域是否高度相关
+- **内容质量**：深度、广度、实例丰富程度、可操作性
+- **互补性**：候选是否包含官方 skill 未涵盖的独特章节
+
+## 决策标准
+- **skip**：主题不重叠，或官方 skill 已完整覆盖候选内容，合并无额外价值
+- **upgrade**：候选覆盖官方 skill 的全部核心要点，且整体质量明显更高（深度/广度提升 ≥30%），用候选直接替换官方版本
+- **merge**：主题相同但各有独特章节，合并后整体价值更高，需要生成合并后完整内容
+
+## 输出格式
+必须返回严格的 JSON，不含任何其他文本、代码块标记或注释：
+{"action":"upgrade|merge|skip","confidence":0-100,"reasoning":"简短中文说明（<200字）","merged_content":null或合并后完整md字符串}
+
+## merged_content 规则
+- action = merge  → 提供合并后的完整 .md 文件内容（含 frontmatter）
+- action = upgrade → null（直接使用候选原文）
+- action = skip   → null`;
+    const user = `## 官方 Skill（目标）
+
+**ID**: ${official.name}
+**描述**: ${official.description}
+**关键词**: ${official.keywords.join(', ') || '（无）'}
+
+\`\`\`markdown
+${truncate(official.content)}
+\`\`\`
+
+---
+
+## 候选 Skill（来源: ${candidate.source}）
+
+**ID**: ${candidate.id}
+**名称**: ${candidate.name}
+**描述**: ${candidate.description}
+**关键词**: ${candidate.keywords.join(', ') || '（无）'}
+
+\`\`\`markdown
+${truncate(candidate.content)}
+\`\`\`
+
+---
+
+请评估候选 skill 相对于官方 skill 的升级价值，返回 JSON。`;
+    return { system, user };
+}
+//# sourceMappingURL=upgrade-prompt.js.map

package/dist/skills/upgrade-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-prompt.js","sourceRoot":"","sources":["../../src/skills/upgrade-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B;;;GAGG;AACH,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAQ,GAAG,iBAAiB;IAC1D,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,4BAA4B,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAyB,EACzB,QAAuB;IAEvB,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;yBAqBQ,CAAC;IAExB,MAAM,IAAI,GAAG;;UAEL,QAAQ,CAAC,IAAI;UACb,QAAQ,CAAC,WAAW;WACnB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK;;;EAG9C,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;;;;;kBAKV,SAAS,CAAC,MAAM;;UAExB,SAAS,CAAC,EAAE;UACZ,SAAS,CAAC,IAAI;UACd,SAAS,CAAC,WAAW;WACpB,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK;;;EAG/C,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;uCAKU,CAAC;IAEtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/docs/design/skill-ai-upgrade-spec-20260518-1930.md

@@ -0,0 +1,297 @@
+# AI 辅助 official skill 升级 Spec
+
+## 目标
+
+为 `claude-forge` 新增 `cf skills upgrade` 命令，通过 AI 评估将外部开源 skill 仓库（addyosmani/agent-skills、obra/superpowers）的优质内容合并进 `src/skills/official/*.md`（永久内置 skill），而不是让它们在用户目录独立存在。整个流程默认 dry-run，用户审核 markdown 报告后执行 `--apply`。
+
+## 用户决策（已通过对话确认）
+
+| 决策点 | 确认值 |
+|--------|--------|
+| 候选源目录 | `~/.claude-forge/skill-candidates/<source-name>/` |
+| AI 评估使用 | `config.ai.model` + `config.ai.base_url` |
+| 覆盖目标 | `src/skills/official/*.md`（编译进 dist 的永久内置） |
+| 报告路径 | `~/.claude-forge/skill-upgrade-report.md` |
+| 默认行为 | dry-run（只生成报告） |
+| `--apply` 行为 | 读取报告中 action，备份后覆写源码 |
+| 备份路径 | `~/.claude-forge/backups/skills/<timestamp>/`（已有 FORGE_PATHS.backups('skills')） |
+
+## 数据流图
+
+```
+[cf skills upgrade]
+    │
+    ▼
+[1] pullCandidates()
+    ├─ git clone/pull ~/.claude-forge/skill-candidates/agent-skills/
+    └─ git clone/pull ~/.claude-forge/skill-candidates/superpowers/
+    │
+    ▼
+[2] scanCandidateFiles()
+    └─ 遍历 .md 文件，解析 frontmatter → CandidateSkill[]
+    │
+    ▼
+[3] matchToOfficial()       (per candidate)
+    └─ tag/keyword 模糊匹配 → MatchResult (official id | null)
+    │
+    ▼
+[4] evaluateWithAI()        (有 official 匹配时才调用)
+    └─ ClaudeProvider.complete() → UpgradeDecision (JSON)
+    │
+    ▼
+[5] generateReport()
+    └─ ~/.claude-forge/skill-upgrade-report.md
+    │
+    ▼ (用户审核)
+    │
+[cf skills upgrade --apply]
+    │
+    ▼
+[6] applyDecisions()
+    ├─ git status 工作树检查
+    ├─ backup src/skills/official/ → backups/skills/<ts>/
+    └─ 覆写 src/skills/official/<id>.md
+```
+
+## 模块设计
+
+### Module 1: `src/skills/upgrade-engine.ts`
+
+**职责**：编排全流程，不含 AI prompt 字符串逻辑。
+
+```ts
+export interface CandidateSkill {
+  id: string;
+  source: string;       // 'agent-skills' | 'superpowers'
+  filePath: string;
+  name: string;
+  description: string;
+  keywords: string[];
+  content: string;
+}
+
+export interface MatchResult {
+  officialId: string;
+  score: number;        // 0-100，关键词重叠率
+}
+
+export type UpgradeAction = 'upgrade' | 'merge' | 'skip';
+export interface UpgradeDecision {
+  action: UpgradeAction;
+  confidence: number;       // 0-100
+  reasoning: string;
+  merged_content: string | null;
+}
+
+export interface ReportEntry {
+  officialId: string;
+  candidateId: string;
+  candidateSource: string;
+  action: UpgradeAction | 'error' | 'needs_review';
+  confidence: number;
+  reasoning: string;
+  candidateFilePath: string;
+  merged_content: string | null;
+}
+
+export async function pullCandidates(
+  sources: Array<{ name: string; url: string }>,
+  candidatesDir: string,
+): Promise<CandidateSkill[]>
+
+export function matchToOfficial(
+  candidate: CandidateSkill,
+  officialSkills: OfficialSkill[],
+): MatchResult | null   // null = 无匹配（score < 30）
+
+export async function evaluateWithAI(
+  candidate: CandidateSkill,
+  official: OfficialSkill,
+  aiProvider: ClaudeProvider,
+): Promise<UpgradeDecision>
+
+export async function generateReport(
+  entries: ReportEntry[],
+  outputPath: string,
+  stats: { total: number; matched: number; unmatched: number },
+): Promise<void>
+
+export async function applyDecisions(
+  reportPath: string,
+  officialDir: string,
+  backupBaseDir: string,
+): Promise<{ applied: number; skipped: number; backupPath: string }>
+```
+
+**关键逻辑**：
+- `pullCandidates`：单源失败 try/catch 跳过
+- `matchToOfficial`：keywords + name token overlap，阈值 30 分（满分 100）
+- `evaluateWithAI`：`maxTokens: 1200, timeoutMs: 45000`；JSON 解析失败返回 skip + needs_review
+- `applyDecisions`：apply 前 `git status --porcelain` 检查工作树是否干净，脏的话 abort
+
+### Module 2: `src/skills/upgrade-prompt.ts`
+
+```ts
+export function buildEvaluationPrompt(
+  candidate: CandidateSkill,
+  official: OfficialSkill,
+): { system: string; user: string }
+```
+
+**System prompt 要点**：
+```
+你是 Claude Code skill 内容评估专家。
+评估维度：主题重叠度 / 内容质量 / 互补性
+返回严格 JSON（不含其他文本）：
+{"action":"upgrade|merge|skip","confidence":0-100,"reasoning":"...","merged_content":null或合并后完整md}
+
+决策标准：
+- skip：主题不重叠，或 official 已完整覆盖
+- upgrade：候选覆盖 official 全部要点且质量明显更高（+30% depth/breadth）
+- merge：主题相同但各有独特章节，合并后价值更高
+```
+
+**User prompt**：双 skill 内容各截 2000 字 + JSON 要求。
+
+### Module 3: 候选源拉取
+
+```ts
+const DEFAULT_SOURCES = [
+  { name: 'agent-skills', url: 'https://github.com/addyosmani/agent-skills.git' },
+  { name: 'superpowers',  url: 'https://github.com/obra/superpowers.git' },
+];
+```
+
+**扫描兼容**：
+- agent-skills 格式：`<name>/SKILL.md`（目录格式）
+- superpowers 格式：顶层 `*.md`（平铺）
+- 复用 `SkillRegistry.scan()` 的格式识别逻辑
+
+### Module 4: CLI 子命令
+
+```ts
+skills
+  .command('upgrade')
+  .description('AI-assisted upgrade of official skills (dry-run by default)')
+  .option('--apply', 'Apply decisions from the last report')
+  .option('--rollback <timestamp>', 'Rollback to a backup')
+  .option('--report <path>', 'Custom report path')
+  .action(async (options) => { await upgradeSkills(options); });
+```
+
+## AI 输出契约
+
+```ts
+type UpgradeDecision = {
+  action: 'upgrade' | 'merge' | 'skip';
+  confidence: number;        // 0-100 整数
+  reasoning: string;         // 简短中文 < 200 字
+  merged_content: string | null;
+  // merged_content 规则：
+  //   merge   → 完整合并后 .md（含 frontmatter）
+  //   upgrade → null（直接用候选原文）
+  //   skip    → null
+};
+```
+
+容错：`JSON.parse` 失败 → `action: skip, needs_review: true`，不阻断。
+
+## 报告格式
+
+```markdown
+# Skill Upgrade Report
+
+Generated: 2026-05-18 19:30 | Model: claude-opus-4-7
+
+## Summary
+
+| Metric | Count |
+|--------|-------|
+| Candidates scanned | 37 (23 agent-skills + 14 superpowers) |
+| Matched to official | 12 |
+| Action: upgrade | 5 |
+| Action: merge | 4 |
+| Action: skip | 3 |
+| Unmatched | 25 |
+
+## Per-Skill Decisions
+
+### official-db-schema-design
+- **Action**: upgrade
+- **Confidence**: 85%
+- **Candidate**: `agent-skills/database-design`
+- **Reasoning**: 候选增加"分库分表策略"和"迁移工具对比"...
+
+<!-- upgrade-entry: official-db-schema-design | <candidatePath> | upgrade -->
+```
+
+**机器可读标记**：HTML 注释 `<!-- upgrade-entry: <id> | <path> | <action> -->`；merge 用 `<!-- merged-content-begin -->...<!-- merged-content-end -->` 包裹合并内容。`--apply` 解析这些注释。
+
+## 备份机制
+
+```
+~/.claude-forge/backups/skills/
+  └── 20260518-1930/
+        ├── official-tdd.md
+        └── ... (所有 official .md 快照)
+```
+
+- 只在 `--apply` 触发备份
+- `--rollback <ts>` 还原
+- 复用 `FORGE_PATHS.backups('skills')`
+- 同 ts 已存在则追加 `-2`、`-3`
+
+## 错误处理
+
+| 场景 | 处理 |
+|------|------|
+| git clone/pull 失败 | warn + 跳过该 source |
+| AI JSON 解析失败 | needs_review，继续 |
+| AI API 超时/5xx | retry 2 次失败 → error 标记 |
+| `--apply` 工作树脏 | abort，提示先 commit |
+| 候选无 frontmatter | 用文件名作 id，keywords=[] |
+| 同 ts 备份冲突 | 后缀 -2 -3 |
+
+## 改造范围
+
+| 文件 | 操作 | 行数估计 |
+|------|------|---------|
+| `src/skills/upgrade-engine.ts` | 新增 | ~200 |
+| `src/skills/upgrade-prompt.ts` | 新增 | ~60 |
+| `src/cli/commands/skills.ts` | 加 upgrade 子命令 + 函数 | +80 |
+| `src/core/constants.ts` | 加 `skillCandidates` 路径（可选）| +2 |
+
+**不改动**：dist/、daemon、web 路由、hook、SkillRegistry、official-skills.ts。
+
+## 测试策略
+
+| 测试文件 | 内容 |
+|---------|------|
+| `tests/unit/skills/upgrade-engine.test.ts` | mock ClaudeProvider.complete → 三条路径；applyDecisions dry-run 不写；备份目录创建 |
+| `tests/unit/skills/upgrade-prompt.test.ts` | system/user prompt 含必要字段；JSON 格式要求 |
+| `tests/unit/skills/upgrade-engine-parse.test.ts` | AI 非 JSON → needs_review；合法 JSON 正确解析 |
+
+集成测试可选：本地 mock .md 跑 dry-run 全流程。
+
+## 风险与回滚
+
+| 风险 | 缓解 |
+|------|------|
+| AI 误判覆盖好 skill | 默认 dry-run；apply 强制 backup；--rollback 还原 |
+| 覆写后 build 错 | apply 后提示 `npm run build` 验证 |
+| API 成本 | 仅 score>=30 调 AI；截 2000 字；预估 ~18K tokens / 12 matched |
+| 候选仓库结构变化 | 单源失败不阻断 |
+
+## 实施顺序
+
+1. **upgrade-prompt.ts**（纯函数，无依赖）
+2. **upgrade-engine.ts** — matchToOfficial → evaluateWithAI → pullCandidates → generateReport → applyDecisions
+3. **cli/commands/skills.ts** — 注册 upgrade 子命令
+4. （可选）`FORGE_PATHS.skillCandidates`
+5. 测试：upgrade-prompt → upgrade-engine（mock）→ CLI e2e
+
+## 命名遵循
+
+- 文件：kebab-case
+- 函数：动词开头 camelCase（`pullCandidates` / `matchToOfficial`）
+- 类型：PascalCase（`CandidateSkill` / `UpgradeDecision`）

package/docs/implementation/daemon-skill-sync-changelog-20260518-2000.md

@@ -0,0 +1,22 @@
+# daemon skill 自动同步 Changelog
+
+**Date**: 2026-05-18 20:00
+**Status**: 完成
+
+## 背景
+类比 v8.51.1 hook-sync：npm 升级 dist/skills/official/ 但不会自动同步
+~/.claude/skills/ 本地副本，SkillRegistry 优先级 user > official 加载
+旧副本，导致 skill 残缺/功能错乱。
+
+## 改动
+- 新建 src/daemon/skill-sync.ts: syncSkills() sha256 比对自动同步
+- daemon/index.ts 启动时调用（紧挨 syncHooks）
+- 失败 logger.warn 不阻断
+
+## 测试
+- 5 case 单测全过
+- 现有测试不退化
+- tsc 0 errors
+
+## 已知问题
+- linkEventToTask pre-existing（sqlite-refactor-harness.test.ts）

package/docs/implementation/skill-ai-upgrade-changelog-20260518-1930.md

@@ -0,0 +1,49 @@
+# AI 辅助 skill 升级 Changelog
+
+**Date**: 2026-05-18 19:30
+**Spec**: docs/design/skill-ai-upgrade-spec-20260518-1930.md
+**Status**: 完成
+
+## 完成清单
+
+- [x] `src/skills/upgrade-prompt.ts` — buildEvaluationPrompt 纯函数
+- [x] `src/skills/upgrade-engine.ts` — 5 个 pipeline 函数 + 全部类型定义
+- [x] `src/cli/commands/skills.ts` — upgrade 子命令 + upgradeSkills() 函数
+- [x] `src/core/constants.ts` — 新增 skillCandidates / skillUpgradeReport 路径
+- [x] 单测 3 文件（44 个新测试用例全过）
+
+## 关键代码定位
+
+- `src/skills/upgrade-prompt.ts:14` — `buildEvaluationPrompt()` system/user prompt 构造
+- `src/skills/upgrade-engine.ts:105` — `pullCandidates()` git clone/pull + .md 扫描
+- `src/skills/upgrade-engine.ts:141` — `matchToOfficial()` Jaccard 关键词重叠评分（阈值 30/100）
+- `src/skills/upgrade-engine.ts:183` — `evaluateWithAI()` AI 调用 + JSON 容错解析
+- `src/skills/upgrade-engine.ts:237` — `generateReport()` markdown + HTML 注释机器标记
+- `src/skills/upgrade-engine.ts:284` — `applyDecisions()` git status 检查 + 备份 + 写文件
+- `src/cli/commands/skills.ts:126` — `upgradeSkills()` 全流程协调（dry-run / apply / rollback）
+
+## 测试结果
+
+- 新增测试: 44 passed（upgrade-prompt: 11, upgrade-engine: 22, upgrade-engine-parse: 11）
+- tsc: 0 errors
+- npm test: 614 passed / 615 total（1 pre-existing failure: linkEventToTask）
+- build: 成功
+
+## 实施决策
+
+1. **ClaudeProvider.complete() 接口**: 使用 `complete(prompt, options)` 形式，其中 `options.system` 传递 system prompt。经查 `src/core/ai/provider.ts` 确认签名。
+
+2. **require('node:fs') 用于同步读文件**: `parseCandidateFile` 使用同步 `readFileSync`，通过 `require('node:fs')` 调用（ESM 模块中已有 `import fs` 但需要同步读取）。
+
+3. **matchToOfficial 评分策略**: 采用 keyword overlap（权重 60%）+ name/description token overlap（权重 40%）的加权 Jaccard 相似度，而非简单字符串匹配。
+
+4. **evaluateWithAI markdown fence 剥离**: AI 模型有时会将 JSON 包裹在 `\`\`\`json` 代码块中，在 JSON.parse 前统一剥离。
+
+5. **applyDecisions git status**: 使用 `git status --porcelain <officialDir>` 检查工作树。若目标目录不在 git 仓库中（如测试用 tmp 目录），warn 并继续（不 abort）。
+
+6. **备份冲突后缀**: 对 `<YYYYMMDD-HHMM>` 时间戳已存在时，自动追加 `-2`、`-3` 等后缀，通过循环 `fs.access` 找到可用路径。
+
+## 已知问题
+
+- `linkEventToTask` 测试失败：pre-existing，与本次改动无关
+- 手测 deferred：网络环境未验证 git clone 实际可达性；dry-run 流程逻辑已通过 mock 测试覆盖

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@winspan/claude-forge",
-  "version": "8.51.1",
+  "version": "8.53.2",
   "description": "SDLC intelligent orchestration engine for Claude Code",
   "main": "dist/cli/index.js",
   "type": "module",