@stofone/dsh-agent-roster 0.6.2 → 0.8.0

package/orgs/agent-roster-collective/support-triage/roster.yaml

@@ -0,0 +1,58 @@
+# 客服分诊组
+#
+# 本档案由本项目自撰（未复制任何上游文本），用于演示同一座档案库里的多种团队形态。
+# 目录约定：<root>/<roster-id>/roster.yaml，且 roster 必须等于目录名。
+kind: dsh-agent-roster/v1
+roster: support-triage
+version: 1.0.0
+title: 客服分诊组
+description: 把每条来信分到“能自助、要人接、是缺陷”三条路之一。
+license: MIT
+maintainers:
+  - STofone
+tags:
+  - support
+  - triage
+
+defaults:
+  provider: deepseek
+  model: deepseek-v4.1-flash
+  reasoningEffort: high
+
+members:
+  - name: lead
+    role: 分诊负责人
+    title: 定分类口径与升级线
+    description: 维护分类表与升级条件；不直接回复用户。
+    systemPrompt: |
+      你维护分诊口径：三类（可自助 / 需人工 / 疑似缺陷）各自的判定条件与升级线。
+      不写具体回复；你负责让分诊结果可复核。
+      产出是分类表 + 每条判定的边界例子（含一个反例）。
+      口径冲突时按“宁可升级”处理，并记下这次冲突用于改口径。
+    tags:
+      - taxonomy
+  - name: classifier
+    role: 来信分诊
+    title: 读一遍来信，给出分类与依据
+    description: 按口径分类，摘出关键句作为依据；不确定就升级。
+    toolScope:
+      allow:
+        - read
+    systemPrompt: |
+      你按口径给每条来信分类，并摘出决定分类的那句原话。
+      不回复用户，也不承诺时间；你的产出是分类 + 依据 + 建议下一步。
+      输出“来信摘要 · 分类 · 依据原句 · 建议动作”，一条一行。
+      两类都像时标“不确定并升级”，不要赌。
+    tags:
+      - classification
+  - name: responder
+    role: 回复撰写
+    title: 先承认问题，再给可执行下一步
+    description: 按分诊结论写回复，含复现所需信息与替代方案。
+    systemPrompt: |
+      你写回复：先复述对方遇到的问题，再给可执行的下一步（含需要的环境信息）。
+      不承诺未定的修复时间，也不猜测根因；不确定就写“我们还在确认”。
+      每条回复控制在 150 字内，附一条“若仍不行，请提供 X”。
+      涉及退款、赔偿、法律措辞时停下转人工，不要自行承诺。
+    tags:
+      - response

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stofone/dsh-agent-roster",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "description": "多 Agent 团队的静态成员档案定义与校验层：档案库在面板里看得见、改得动，团队成员的人设、模型与工具边界固化成可校验、可版本化的文件，并在 dsh-agent-teams 创建成员时把档案桥接给运行时。",
   "type": "module",
   "main": "index.js",
@@ -23,6 +23,7 @@
     "schema",
     "icon.svg",
     "examples",
+    "orgs",
     "README.md",
     "README.zh.md",
     "CHANGELOG.md",
@@ -96,5 +97,8 @@
   "meta": {
     "title": "Agent Roster",
     "description": "静态成员档案：定义、校验并桥接多 Agent 团队成员的人设、模型与工具边界。"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-tools": "^0.2.1-rc.2"
   }
 }

package/schema/capabilities.v1.schema.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/STofone/dsh-agent-roster/blob/main/schema/capabilities.v1.schema.json",
+  "title": "DSH agent roster capability requirements",
+  "description": "一份档案的能力要求（与 roster.{yaml,json} 同目录的 capabilities.{yaml,json}）：只声明「建这支队伍需要什么」，不承载能力本体。校验的权威实现是插件里的 lib/capabilities.js；本文件供编辑器与外部工具做提示，两者由 test/capabilities.test.js 对齐。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind",
+    "roster"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "编辑器用的 schema 地址，插件不读它。"
+    },
+    "kind": {
+      "const": "dsh-agent-roster-capabilities/v1"
+    },
+    "roster": {
+      "$ref": "#/$defs/id",
+      "description": "档案 id，必须与同目录的 roster 文件一致。"
+    },
+    "onMissing": {
+      "enum": [
+        "refuse",
+        "degraded"
+      ],
+      "description": "证据源明确显示缺项时的行为：refuse（默认）拒绝生成建队参数；degraded 照常生成，但在每次核对里记成 degraded。"
+    },
+    "asOf": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+      "description": "这份要求是照哪天的部署核对的。只收日期：时分秒会给人「一直新鲜」的错觉。"
+    },
+    "requires": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "只收有证据源的两类。模型路由可用性、插件版本、凭据指针、业务前置条件都没有证据源，写在这里只会变成又一份「看起来声明了」的假绿。",
+      "properties": {
+        "skills": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "$ref": "#/$defs/skillRequirement"
+          }
+        },
+        "toolPolicies": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "$ref": "#/$defs/policyRequirement"
+          }
+        }
+      }
+    },
+    "notes": {
+      "type": "string",
+      "maxLength": 500
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
+    },
+    "skillName": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+    },
+    "policyId": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
+    },
+    "skillRequirement": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/skillName"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "name"
+          ],
+          "properties": {
+            "name": {
+              "$ref": "#/$defs/skillName"
+            },
+            "reason": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            }
+          }
+        }
+      ]
+    },
+    "policyRequirement": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/policyId"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "name"
+          ],
+          "properties": {
+            "name": {
+              "$ref": "#/$defs/policyId"
+            },
+            "reason": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schema/organization.v1.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/STofone/dsh-agent-roster/blob/main/schema/organization.v1.schema.json",
+  "title": "DSH agent roster organization document",
+  "description": "一座档案库的目录页：声明库里有哪几份档案、各自什么状态。校验的权威实现是 lib/organization.js；本文件供编辑器与外部工具提示，两者由 test/organization.test.js 对齐。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "organization", "rosters"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "编辑器用的 schema 地址，插件不读它。"
+    },
+    "kind": { "const": "dsh-agent-roster-organization/v1" },
+    "organization": {
+      "$ref": "#/$defs/id",
+      "description": "组织 id，同时是档案库根目录名。位置即身份。"
+    },
+    "title": { "type": "string", "maxLength": 120 },
+    "description": { "type": "string", "maxLength": 500 },
+    "license": { "type": "string", "maxLength": 120 },
+    "homepage": { "type": "string", "maxLength": 200, "pattern": "^https?://\\S+$" },
+    "maintainers": {
+      "type": "array",
+      "maxItems": 16,
+      "items": { "type": "string", "minLength": 1, "maxLength": 120 }
+    },
+    "rosters": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "description": "登记在案的档案。声明了却找不到目录会报错；目录在却没登记会告警。",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "title": { "type": "string", "maxLength": 120 },
+          "status": { "enum": ["active", "archived"] },
+          "origin": { "type": "string", "maxLength": 120 },
+          "note": { "type": "string", "maxLength": 300 }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{1,63}$" }
+  }
+}

package/schema/registry.v1.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/STofone/dsh-agent-roster/blob/main/schema/registry.v1.schema.json",
+  "title": "DSH agent roster registry document",
+  "description": "公共档案索引：登记若干 collection（仓库 + 目录 + 确有哪几份档案），供订阅与一键安装。权威校验实现是 lib/remote.js#validateRegistry；本文件供编辑器与外部工具提示，两者由 test/registry-schema.test.js 对齐。注意：运行时对未知字段只告警不判错，这里写成 additionalProperties:false 是为了让编辑器早点指出拼写错误。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "collections"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "编辑器用的 schema 地址，插件不读它。"
+    },
+    "kind": { "const": "dsh-agent-roster-registry/v1" },
+    "version": { "type": "integer", "minimum": 1 },
+    "generatedAt": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$",
+      "description": "上一次校验通过的时间，由 CI 或维护者盖章。"
+    },
+    "generator": { "type": "string", "maxLength": 200 },
+    "source": { "type": "string", "maxLength": 200 },
+    "collections": {
+      "type": "array",
+      "maxItems": 500,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "repo"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "title": { "type": "string", "maxLength": 120 },
+          "description": { "type": "string", "maxLength": 500 },
+          "repo": {
+            "type": "string",
+            "pattern": "^(?:github:)?[A-Za-z0-9][A-Za-z0-9_.-]{0,38}/[A-Za-z0-9][A-Za-z0-9_.-]{0,99}$",
+            "description": "仓库坐标，形如 github:owner/repo。"
+          },
+          "ref": {
+            "type": "string",
+            "pattern": "^(?:[A-Za-z0-9][A-Za-z0-9._-]{0,127}|[0-9a-f]{40})$",
+            "default": "main",
+            "description": "分支、标签或 40 位 commit。"
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^(?:/)?(?:[A-Za-z0-9._-]+/)*[A-Za-z0-9._-]*$",
+            "default": "rosters",
+            "description": "仓库内存放档案的目录。"
+          },
+          "rosters": {
+            "type": "array",
+            "maxItems": 200,
+            "description": "目录里确实存在的档案 id。索引不撒谎：不存在的 id 会被 registry sync 剔除。",
+            "items": { "$ref": "#/$defs/id" }
+          },
+          "tags": {
+            "type": "array",
+            "maxItems": 16,
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9][a-z0-9-]{0,31}$"
+            }
+          },
+          "license": { "type": "string", "maxLength": 120 },
+          "maintainers": {
+            "type": "array",
+            "maxItems": 16,
+            "items": { "type": "string", "minLength": 1, "maxLength": 120 }
+          },
+          "homepage": { "type": "string", "maxLength": 200, "pattern": "^https?://\\S+$" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$",
+      "description": "kebab-case 标识，与档案目录名同规则。"
+    }
+  }
+}