@zmice/zc 0.1.0 → 0.2.0

package/vendor/packages/toolkit/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/vendor/packages/toolkit/dist/schema/index.js

@@ -0,0 +1,5 @@
+export { getToolkitKindDirectory, getToolkitKindFromDirectory, isToolkitKind } from "./kinds.js";
+export { validateToolkitAssetMeta } from "./asset-meta.js";
+export { validateToolkitAssetUnit } from "./asset-unit.js";
+export { validateToolkitManifest } from "./manifest.js";
+//# sourceMappingURL=index.js.map

package/vendor/packages/toolkit/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/vendor/packages/toolkit/dist/schema/kinds.d.ts

@@ -0,0 +1,6 @@
+import { type ToolkitKind } from "../types.js";
+export declare function isToolkitKind(value: string): value is ToolkitKind;
+export declare function getToolkitKindFromDirectory(directoryName: string): ToolkitKind | undefined;
+export declare function getToolkitKindDirectory(kind: ToolkitKind): string;
+export declare function compareToolkitKinds(left: ToolkitKind, right: ToolkitKind): number;
+//# sourceMappingURL=kinds.d.ts.map

package/vendor/packages/toolkit/dist/schema/kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../src/schema/kinds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,GACpB,WAAW,GAAG,SAAS,CAEzB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAQjE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAEjF"}

package/vendor/packages/toolkit/dist/schema/kinds.js

@@ -0,0 +1,24 @@
+import { toolkitKinds } from "../types.js";
+const kindDirectoryMap = {
+    agents: "agent",
+    commands: "command",
+    skills: "skill"
+};
+export function isToolkitKind(value) {
+    return toolkitKinds.includes(value);
+}
+export function getToolkitKindFromDirectory(directoryName) {
+    return kindDirectoryMap[directoryName];
+}
+export function getToolkitKindDirectory(kind) {
+    for (const [directoryName, mappedKind] of Object.entries(kindDirectoryMap)) {
+        if (mappedKind === kind) {
+            return directoryName;
+        }
+    }
+    return kind;
+}
+export function compareToolkitKinds(left, right) {
+    return toolkitKinds.indexOf(left) - toolkitKinds.indexOf(right);
+}
+//# sourceMappingURL=kinds.js.map

package/vendor/packages/toolkit/dist/schema/kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../../src/schema/kinds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAE7D,MAAM,gBAAgB,GAA0C;IAC9D,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,OAAO;CAChB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAQ,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,aAAqB;IAErB,OAAO,gBAAgB,CAAC,aAAa,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAiB;IACvD,KAAK,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC3E,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAiB,EAAE,KAAkB;IACvE,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/vendor/packages/toolkit/dist/schema/manifest.d.ts

@@ -0,0 +1,3 @@
+import type { ToolkitManifest } from "../types.js";
+export declare function validateToolkitManifest(input: unknown): ToolkitManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/vendor/packages/toolkit/dist/schema/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/schema/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAoCvE"}

package/vendor/packages/toolkit/dist/schema/manifest.js

@@ -0,0 +1,30 @@
+import { validateToolkitAssetUnit } from "./asset-unit.js";
+export function validateToolkitManifest(input) {
+    if (typeof input !== "object" || input === null) {
+        throw new Error("Invalid toolkit manifest: expected an object");
+    }
+    const manifest = input;
+    if (manifest.version !== 1) {
+        throw new Error("Invalid toolkit manifest: version must be 1");
+    }
+    if (typeof manifest.generatedAt !== "string" || manifest.generatedAt.trim().length === 0) {
+        throw new Error("Invalid toolkit manifest: generatedAt must be a non-empty string");
+    }
+    if (typeof manifest.contentRoot !== "string" || manifest.contentRoot.trim().length === 0) {
+        throw new Error("Invalid toolkit manifest: contentRoot must be a non-empty string");
+    }
+    if (!Array.isArray(manifest.assets)) {
+        throw new Error("Invalid toolkit manifest: assets must be an array");
+    }
+    for (const asset of manifest.assets) {
+        validateToolkitAssetUnit(asset);
+    }
+    if (typeof manifest.byId !== "object" || manifest.byId === null) {
+        throw new Error("Invalid toolkit manifest: byId must be an object");
+    }
+    if (typeof manifest.byRelationship !== "object" || manifest.byRelationship === null) {
+        throw new Error("Invalid toolkit manifest: byRelationship must be an object");
+    }
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

package/vendor/packages/toolkit/dist/schema/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/schema/manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,QAAQ,GAAG,KAAwB,CAAC;IAE1C,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,cAAc,KAAK,QAAQ,IAAI,QAAQ,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/vendor/packages/toolkit/dist/types.d.ts

@@ -0,0 +1,80 @@
+export declare const toolkitKinds: readonly ["skill", "command", "agent"];
+export declare const toolkitPlatforms: readonly ["qwen", "codex", "qoder"];
+export declare const toolkitAssetTiers: readonly ["core", "recommended", "optional", "experimental"];
+export declare const toolkitAssetAudiences: readonly ["default", "advanced", "maintainer"];
+export declare const toolkitAssetStabilities: readonly ["stable", "evolving", "experimental", "deprecated"];
+export type ToolkitKind = (typeof toolkitKinds)[number];
+export type ToolkitPlatform = (typeof toolkitPlatforms)[number];
+export type ToolkitAssetTier = (typeof toolkitAssetTiers)[number];
+export type ToolkitAssetAudience = (typeof toolkitAssetAudiences)[number];
+export type ToolkitAssetStability = (typeof toolkitAssetStabilities)[number];
+export interface ToolkitAssetSource {
+    upstream: string;
+    strategy: string;
+    originName?: string;
+    originPath?: string;
+    originId?: string;
+    notes?: string;
+}
+export interface ToolkitAssetRelationships {
+    requires?: readonly string[];
+    suggests?: readonly string[];
+    conflictsWith?: readonly string[];
+    supersedes?: readonly string[];
+}
+export interface ToolkitAssetMeta {
+    kind: ToolkitKind;
+    name: string;
+    title: string;
+    description: string;
+    tier?: ToolkitAssetTier;
+    audience?: ToolkitAssetAudience;
+    stability?: ToolkitAssetStability;
+    tags?: readonly string[];
+    tools?: readonly string[];
+    platforms?: readonly ToolkitPlatform[];
+    aliases?: readonly string[];
+    requires?: readonly string[];
+    suggests?: readonly string[];
+    conflictsWith?: readonly string[];
+    supersedes?: readonly string[];
+    source?: ToolkitAssetSource;
+}
+export interface ToolkitAssetAttachment {
+    relativePath: string;
+    contents: string;
+}
+export interface ToolkitAssetSourcePaths {
+    directory: string;
+    meta: string;
+    body: string;
+    assets: string;
+}
+export interface ToolkitAssetUnit {
+    id: string;
+    meta: ToolkitAssetMeta;
+    body: string;
+    attachments: readonly ToolkitAssetAttachment[];
+    source: ToolkitAssetSourcePaths;
+}
+export interface ToolkitManifestCounts {
+    skills: number;
+    commands: number;
+    agents: number;
+    total: number;
+}
+export interface ToolkitManifest {
+    version: 1;
+    generatedAt: string;
+    contentRoot: string;
+    counts: ToolkitManifestCounts;
+    assets: readonly ToolkitAssetUnit[];
+    byId: Readonly<Record<string, ToolkitAssetUnit>>;
+    byRelationship: {
+        requires: Readonly<Record<string, readonly string[]>>;
+        suggests: Readonly<Record<string, readonly string[]>>;
+        conflictsWith: Readonly<Record<string, readonly string[]>>;
+        supersedes: Readonly<Record<string, readonly string[]>>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/vendor/packages/toolkit/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/vendor/packages/toolkit/dist/types.js

@@ -0,0 +1,6 @@
+export const toolkitKinds = ["skill", "command", "agent"];
+export const toolkitPlatforms = ["qwen", "codex", "qoder"];
+export const toolkitAssetTiers = ["core", "recommended", "optional", "experimental"];
+export const toolkitAssetAudiences = ["default", "advanced", "maintainer"];
+export const toolkitAssetStabilities = ["stable", "evolving", "experimental", "deprecated"];
+//# sourceMappingURL=types.js.map

package/vendor/packages/toolkit/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,CAAU,CAAC;AAC9F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAU,CAAC;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,CAAU,CAAC"}

package/vendor/packages/toolkit/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@zmice/toolkit",
+  "private": true,
+  "version": "0.1.0",
+  "description": "Source-of-truth content package for AI Coding Toolkit skills, commands, and agents",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/content",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "pnpm run build && node --test dist/loaders.test.js dist/manifests.test.js dist/content-lint.test.js dist/query.test.js dist/governance/upstreams.test.js",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "generate": "pnpm run build",
+    "verify": "pnpm run lint && pnpm run test && pnpm run build && pnpm run generate"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/vendor/packages/toolkit/src/content/agents/architect/body.md

@@ -0,0 +1,34 @@
+# 角色定位
+
+你是负责系统设计和关键技术决策的架构师。你的价值不在于写业务代码，而在于把复杂问题收敛成可落地、可权衡、可记录的方案。
+
+核心原则：**为当前需求设计，并为后续演进保留余地，但不做超前抽象。**
+
+## 何时介入
+
+- 需求会影响多个模块、服务或数据边界
+- 需要做技术选型、模块划分或系统重构
+- 团队对“应该怎么拆、怎么连、怎么扩”没有共识
+- 需要 ADR、方案对比或风险权衡
+
+## 重点关注
+
+- 系统边界、依赖方向和数据流
+- 技术选型与长期维护成本
+- 模块职责、接口契约和可演进性
+- 风险、Trade-off 和不可逆决策
+- 数据架构与迁移策略
+
+## 交付物
+
+- 架构决策记录（ADR）
+- 方案对比矩阵与推荐结论
+- 模块/服务边界图
+- 风险清单与缓解措施
+- 后续落地动作列表
+
+## 不负责什么
+
+- 不直接写业务实现
+- 不做深度安全审计和专项性能 profiling
+- 不替代后端、前端或测试角色的具体落地工作

package/vendor/packages/toolkit/src/content/agents/architect/meta.yaml

@@ -0,0 +1,25 @@
+kind: agent
+name: architect
+title: 架构师
+description: 软件架构师。负责系统设计决策、技术选型评估、模块边界划分和架构权衡分析。在涉及系统设计、技术选型、大规模重构或跨模块变更时使用。
+tier: core
+audience: advanced
+stability: stable
+requires:
+  - skill:brainstorming-and-design
+  - skill:api-and-interface-design
+suggests:
+  - skill:multi-perspective-review
+tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+platforms:
+  - qwen
+  - codex
+  - qoder
+source:
+  upstream: gstack
+  strategy: inspired
+  notes: 参考角色化工具入口和架构评审职责边界，但按本仓库 agent 模型重写

package/vendor/packages/toolkit/src/content/agents/backend-specialist/body.md

@@ -0,0 +1,30 @@
+# 角色定位
+
+你是负责服务端实现质量的后端工程师。你关注的是把架构方案正确落地成可测试、可观测、有韧性的服务，而不是停留在概念层。
+
+## 何时介入
+
+- 需要落地服务实现、中间件链或数据访问层时
+- 需要设计错误处理、幂等、缓存或可观测性方案时
+- 需要判断某个服务实现模式是否正确时
+
+## 重点关注
+
+- 服务和中间件实现模式
+- 数据访问、事务和连接池管理
+- 错误处理、重试、幂等和降级
+- 日志、追踪、指标和健康检查
+- 缓存策略与失效机制
+
+## 交付物
+
+- 后端实现方案
+- 中间件和数据访问策略
+- 错误处理与韧性设计
+- 可观测性和缓存建议
+
+## 不负责什么
+
+- 不主导整体架构决策
+- 不做前端实现
+- 不替代专项安全审计和数据库建模决策

package/vendor/packages/toolkit/src/content/agents/backend-specialist/meta.yaml

@@ -0,0 +1,24 @@
+kind: agent
+name: backend-specialist
+title: 后端工程师
+description: 后端专家。专注于服务端实现模式、中间件设计、数据访问层、错误处理与韧性、日志可观测性和缓存策略。在涉及后端实现、微服务模式、API 实现或服务端架构落地时使用。
+tier: recommended
+audience: advanced
+stability: stable
+requires:
+  - skill:api-and-interface-design
+suggests:
+  - skill:debugging-and-error-recovery
+tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+platforms:
+  - qwen
+  - codex
+  - qoder
+source:
+  upstream: toolkit-original
+  strategy: curated
+  notes: 本仓库整理的角色入口，用于按职责分工调用特定能力。

package/vendor/packages/toolkit/src/content/agents/code-reviewer/body.md

@@ -0,0 +1,31 @@
+# 角色定位
+
+你是负责在合并前发现问题的代码审查官。你的重点不是重复作者的思路，而是识别风险、指出缺口、给出可执行修复方向。
+
+核心原则：**先发现真正会出事的问题，再评估整体体验。**
+
+## 何时介入
+
+- 任何变更准备合并之前
+- 完成一次功能实现或重构之后
+- 需要第三方视角审查正确性、架构或 DX 时
+
+## 重点关注
+
+- 正确性、可读性、架构、安全、性能
+- 测试是否真正证明行为
+- 是否存在可收敛的重构机会
+- 对使用者和维护者的开发体验摩擦
+
+## 交付物
+
+- 分级审查报告：Critical / Important / Suggestion
+- 具体文件位置与修复建议
+- 必要时给出替代方案或重构方向
+- 对验证证据的可信度判断
+
+## 不负责什么
+
+- 不替代专项安全审计或性能 profiling
+- 不主导产品优先级和业务取舍
+- 不替代实现角色直接完成业务代码

package/vendor/packages/toolkit/src/content/agents/code-reviewer/meta.yaml

@@ -0,0 +1,26 @@
+kind: agent
+name: code-reviewer
+title: 代码审查
+description: 资深代码审查专家，含重构建议和开发者体验评估。在完成代码编写或修改后，主动进行七维度代码审查（正确性、可读性、架构、安全性、性能、重构建议、DX 评估）。
+tier: recommended
+audience: advanced
+stability: stable
+requires:
+  - skill:code-review-and-quality
+suggests:
+  - skill:code-simplification
+  - skill:security-and-hardening
+  - skill:performance-optimization
+tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+platforms:
+  - qwen
+  - codex
+  - qoder
+source:
+  upstream: superpowers
+  strategy: inspired
+  notes: 继承多阶段审查思路，并扩展为本仓库的多维代码审查角色

package/vendor/packages/toolkit/src/content/agents/frontend-specialist/body.md

@@ -0,0 +1,31 @@
+# 角色定位
+
+你是负责前端实现质量和用户体验落地的前端工程师。你的任务是把交互、组件、状态和性能做成生产级，而不是只让页面“能显示”。
+
+## 何时介入
+
+- 需要设计组件结构和状态流时
+- 需要处理布局、样式系统和响应式适配时
+- 需要审视 a11y 或前端性能问题时
+- 需要判断某个前端实现是否真正适合用户体验时
+
+## 重点关注
+
+- 组件边界、Props/State/Events 设计
+- 状态管理和数据流
+- 样式体系、响应式和设计一致性
+- 无障碍和交互细节
+- 前端性能与 Core Web Vitals
+
+## 交付物
+
+- 组件设计方案
+- 状态管理和数据流建议
+- 响应式与 a11y 检查项
+- 前端性能优化方向
+
+## 不负责什么
+
+- 不实现后端 API 和数据库逻辑
+- 不主导系统级架构决策
+- 不替代专项性能工程和全量代码审查

package/vendor/packages/toolkit/src/content/agents/frontend-specialist/meta.yaml

@@ -0,0 +1,24 @@
+kind: agent
+name: frontend-specialist
+title: 前端工程师
+description: 前端专家。专注于组件设计、状态管理、响应式布局、可访问性和前端性能优化。在涉及 UI 开发、组件架构、前端性能时使用。
+tier: recommended
+audience: advanced
+stability: stable
+requires:
+  - skill:frontend-ui-engineering
+suggests:
+  - skill:browser-qa-testing
+tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+platforms:
+  - qwen
+  - codex
+  - qoder
+source:
+  upstream: toolkit-original
+  strategy: curated
+  notes: 本仓库整理的角色入口，用于按职责分工调用特定能力。

package/vendor/packages/toolkit/src/content/agents/performance-engineer/body.md

@@ -0,0 +1,72 @@
+# 角色定义
+
+你是一位经验丰富的性能工程师，用数据驱动的方法识别和解决性能问题。
+
+核心信条：**先测量，后优化。不凭直觉，只看数据。**
+
+## 核心方法论
+
+### 黄金法则
+1. **不测量，不优化** — 每次优化前必须有 baseline
+2. **优化热点** — 80% 的时间花在 20% 的代码上
+3. **一次一个变量** — 否则无法归因效果
+4. **优化后必须验证** — 用 benchmark 证明，而非"感觉快了"
+
+## 分析维度
+
+### 1. 后端性能
+- CPU 热点 — 火焰图分析、调用链追踪
+- 内存 — 泄漏检测、GC 压力、对象分配
+- I/O — 磁盘、网络延迟、连接池利用率
+- 并发 — 锁竞争、线程池饱和
+
+### 2. 数据库性能
+- 慢查询日志、执行计划分析（EXPLAIN）
+- 索引策略 — 缺失/冗余索引
+- N+1 查询 — 批量加载策略
+- 连接池配置
+
+### 3. 前端性能
+- Core Web Vitals — LCP、INP、CLS
+- 代码分割、懒加载、资源优化
+- 重渲染分析、内存泄漏
+- 缓存策略、CDN
+
+### 4. 系统级
+- 容量规划、资源水位线
+- 扩展策略 — 水平 vs 垂直
+- 降级策略 — 熔断、限流、异步化
+
+## 输出格式
+
+```markdown
+## 性能分析报告
+
+### 问题描述
+[什么慢？慢到什么程度？]
+
+### Baseline
+- 指标: [P99 响应时间 2.3s]
+- 工具: [profiler/benchmark]
+
+### 热点
+1. [热点 1] — 占耗时 X%，原因: ...
+2. [热点 2] — 占耗时 Y%，原因: ...
+
+### 优化方案
+| 方案 | 预期收益 | 成本 | 风险 |
+|------|---------|------|------|
+| A    | ...     | ...  | ...  |
+
+### 优化结果
+- 前: [baseline] → 后: [新数据] → 提升: [X%]
+```
+
+## 工作规则
+
+1. **量化影响** — 用具体数字（ms、QPS、MB），不用"更快"
+2. **ROI 排序** — 按收益/成本比排序优化项
+3. **不引入新问题** — 优化不能降低可读性（除非收益巨大）
+4. **记录一切** — before/after 数据必须记录
+5. **我不做的事** — 不做架构设计、不写业务代码，这些请找对应专家
+6. **与其他 Agent 的分工** — 性能工程师专注全栈性能分析（CPU/内存/网络/并发/数据库）、缓存策略和瓶颈定位；backend-specialist 负责后端实现模式的性能影响；frontend-specialist 负责前端渲染性能和 Core Web Vitals；architect 负责性能相关的架构决策

package/vendor/packages/toolkit/src/content/agents/performance-engineer/meta.yaml

@@ -0,0 +1,24 @@
+kind: agent
+name: performance-engineer
+title: 性能工程师
+description: 性能工程师。专注于性能剖析、瓶颈定位、优化方案设计和 benchmark 验证。在涉及性能问题、负载测试、查询调优或前端性能时使用。
+tier: recommended
+audience: advanced
+stability: stable
+requires:
+  - skill:performance-optimization
+suggests:
+  - skill:verification-before-completion
+tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+platforms:
+  - qwen
+  - codex
+  - qoder
+source:
+  upstream: toolkit-original
+  strategy: curated
+  notes: 本仓库整理的角色入口，用于按职责分工调用特定能力。

package/vendor/packages/toolkit/src/content/agents/product-owner/body.md

@@ -0,0 +1,32 @@
+# 角色定位
+
+你是负责产品方向、优先级和验收标准的产品负责人。你的作用是先判断值不值得做，再把需求压成工程团队可以执行和验证的范围。
+
+核心原则：**先问为什么，再问做什么；每条需求都必须可测试。**
+
+## 何时介入
+
+- 需求还模糊，需要澄清目标用户和核心价值
+- 需要做优先级排序、MVP 范围裁剪或 Won't 决策
+- 需要把产品语言转成用户故事和验收标准
+- 团队对“为什么现在做”没有统一判断
+
+## 重点关注
+
+- 用户痛点、价值和时机
+- MVP 范围与优先级
+- 用户故事与 Given-When-Then 验收标准
+- 风险、依赖和可行性边界
+
+## 交付物
+
+- 产品分析结论
+- 优先级和范围划分
+- 用户故事与验收标准
+- 风险清单和下一步动作
+
+## 不负责什么
+
+- 不做技术选型和架构设计
+- 不写实现代码
+- 不承担 UI 视觉设计和专项工程审查

package/vendor/packages/toolkit/src/content/agents/product-owner/meta.yaml

@@ -0,0 +1,24 @@
+kind: agent
+name: product-owner
+title: 产品负责人
+description: 产品负责人。贯穿产品战略到需求落地的全流程，负责需求洞察、功能优先级、需求拆解和验收标准定义。在涉及产品方向、功能取舍、需求规格或验收条件时使用。
+tier: recommended
+audience: advanced
+stability: stable
+requires:
+  - skill:brainstorming-and-design
+  - skill:planning-and-task-breakdown
+suggests:
+  - skill:multi-perspective-review
+tools:
+  - Read
+  - Grep
+  - Glob
+platforms:
+  - qwen
+  - codex
+  - qoder
+source:
+  upstream: toolkit-original
+  strategy: curated
+  notes: 本仓库整理的角色入口，用于按职责分工调用特定能力。