mirror of
https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli.git
synced 2026-09-29 16:57:48 +08:00
docs: drop multi skill experimental banners
Remove EXPERIMENTAL/Preview banners from skill setup, install scripts, README, and misc references so multi mode is no longer framed as unstable preview. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
玉澜
@@ -71,9 +71,7 @@ The installer ships skills in one of two layouts. CLI commands (`dws aitable ...
|
||||
| Mode | What gets installed | Best for |
|
||||
|------|----------------------|----------|
|
||||
| **mono** (stable, default) | One `dws` skill covering all products | Cross-product workflows; single entry point |
|
||||
| **multi** 🧪 **EXPERIMENTAL** | Per-product skills (`dingtalk-aitable`, `dingtalk-calendar`, `dingtalk-chat`, ...) | Single-product tasks; smaller context per call |
|
||||
|
||||
> 🧪 **`multi` is currently EXPERIMENTAL / preview.** All product-scoped skills pass the dispatch verifier, but interface, naming and cross-skill references may change in future releases. For production / shared environments, prefer `mono`. File issues if you hit problems.
|
||||
| **multi** | Per-product skills (`dingtalk-aitable`, `dingtalk-calendar`, `dingtalk-chat`, ...) | Single-product tasks; smaller context per call |
|
||||
|
||||
How to pick:
|
||||
|
||||
@@ -394,7 +392,7 @@ dws aitable record query --base-id BASE_ID --table-id TABLE_ID --limit 10
|
||||
The repo ships a complete Agent Skill system under `skills/`, organized into two layouts:
|
||||
|
||||
- `skills/mono/` — single-skill layout (one `SKILL.md` + `references/products/`), recommended default.
|
||||
- `skills/multi/` — per-product skills (`dingtalk-aitable/`, `dingtalk-calendar/`, `dingtalk-chat/`, ...), each with its own `SKILL.md`. 🧪 **EXPERIMENTAL / preview — see banner in each multi `SKILL.md` for caveats.**
|
||||
- `skills/multi/` — per-product skills (`dingtalk-aitable/`, `dingtalk-calendar/`, `dingtalk-chat/`, ...), each with its own `SKILL.md`.
|
||||
|
||||
Leaf safety/parameters/selection prose for Schema generation come from ProductDecl / ContractFinal declarations in Go. The former `internal/cli/schema_hints/` HintFile tree is fully retired and must not reappear.
|
||||
|
||||
|
||||
+2
-4
@@ -71,9 +71,7 @@ irm https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/ma
|
||||
| 模式 | 安装内容 | 适合场景 |
|
||||
|------|----------|----------|
|
||||
| **mono**（稳定，默认） | 一个 `dws` skill，覆盖全部产品 | 跨产品组合操作；单一入口召唤 |
|
||||
| **multi** 🧪 **试验版 / Preview** | 按产品拆分的独立 skill（`dingtalk-aitable` / `dingtalk-calendar` / `dingtalk-chat` ...） | 单产品任务；每次召唤上下文更小 |
|
||||
|
||||
> 🧪 **multi 模式当前为 EXPERIMENTAL（试验版 / Preview）**。全部独立 skill 均通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整。生产 / 共享环境建议优先用 `mono`。问题请提 issue 反馈。
|
||||
| **multi** | 按产品拆分的独立 skill（`dingtalk-aitable` / `dingtalk-calendar` / `dingtalk-chat` ...） | 单产品任务；每次召唤上下文更小 |
|
||||
|
||||
怎么选：
|
||||
|
||||
@@ -388,7 +386,7 @@ dws aitable record query --base-id BASE_ID --table-id TABLE_ID --limit 10
|
||||
仓库内置完整的 Agent Skill 体系（`skills/` 目录），分为两套布局：
|
||||
|
||||
- `skills/mono/` — 单 skill 布局（一个 `SKILL.md` + `references/products/`），默认推荐。
|
||||
- `skills/multi/` — 每个产品一个独立 skill（`dingtalk-aitable/` / `dingtalk-calendar/` / `dingtalk-chat/` ...），每个 skill 自带 `SKILL.md`。🧪 **试验版 / Preview — 各 multi `SKILL.md` 头部有详细注意事项。**
|
||||
- `skills/multi/` — 每个产品一个独立 skill（`dingtalk-aitable/` / `dingtalk-calendar/` / `dingtalk-chat/` ...），每个 skill 自带 `SKILL.md`。
|
||||
|
||||
Schema 生成的叶子 safety/参数/选型文案由 Go 中的 ProductDecl / ContractFinal 声明驱动。原 `internal/cli/schema_hints/` HintFile 目录已完全退役，不得重新引入。
|
||||
|
||||
|
||||
@@ -55,7 +55,7 @@ orphan_scripts_allowlist:
|
||||
| X2 | chat 死链 `extract_media_id.py` | n/a | 现仅为反模式提及 |
|
||||
| X3 | routing → markdown 错路径 | **done** | 已指 `dingtalk-misc/references/markdown.md`；drive 尾链已修 |
|
||||
| X4 | event 缺 metadata | **done** | |
|
||||
| X5 | EXPERIMENTAL「优先 mono」文案 | **done** | 五 skill 已去「优先 mono」 |
|
||||
| X5 | multi skill 横幅 /「优先 mono」文案 | **done** | 横幅已全部移除 |
|
||||
| X6 | SAFETY_PREAMBLE_INJECT 无注入器 | **done** | 标记已移除 |
|
||||
|
||||
产品面覆盖：见 YAML `coverage`——mono products 均有 multi 承接（misc 聚合 attendance/oa/sheet/…）。
|
||||
|
||||
@@ -2008,8 +2008,8 @@ func TestCrossPlatformCoverageSkillSetupRuntimeCoverage(t *testing.T) {
|
||||
if _, err := os.Stat(filepath.Join(home, ".agents", "skills", "dws", "SKILL.md")); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
if output, warnings, err := run("--mode", "multi", "--source", multi, "--target", "agents", "--yes", "--skill", "a"); err != nil || !strings.Contains(output, "installed=2") || warnings == "" {
|
||||
t.Fatalf("multi setup = %q / %q, %v", output, warnings, err)
|
||||
if output, _, err := run("--mode", "multi", "--source", multi, "--target", "agents", "--yes", "--skill", "a"); err != nil || !strings.Contains(output, "installed=2") {
|
||||
t.Fatalf("multi setup = %q, %v", output, err)
|
||||
}
|
||||
if _, err := os.Stat(filepath.Join(home, ".agents", "skills", "dingtalk-shared", "SKILL.md")); err != nil {
|
||||
t.Fatal(err)
|
||||
|
||||
@@ -75,10 +75,8 @@ func newSkillSetupCommand() *cobra.Command {
|
||||
Long: `安装 dws 自身 skill 文档到 AI Agent 目录（如 ~/.claude/skills/、~/.cursor/skills/ 等）。
|
||||
|
||||
支持两种模式：
|
||||
mono 单 skill（稳定 / 推荐）—— 总入口 SKILL.md + references/products/
|
||||
multi 🧪 EXPERIMENTAL 多 skill（试验版 / Preview）—— 按产品拆 N 个独立 skill
|
||||
尚未达到 stable 标准，接口、命名与跨 skill 引用可能变动；
|
||||
生产前请评估，问题请提 issue 反馈
|
||||
mono 单 skill（稳定 / 推荐）—— 总入口 SKILL.md + references/products/
|
||||
multi 多 skill—— 按产品拆 N 个独立 skill
|
||||
|
||||
multi 模式支持按产品挑选：
|
||||
-s/--skill 只装指定子 skill（可重复，短名 aitable 或全名 dingtalk-aitable 均可）
|
||||
@@ -177,8 +175,6 @@ func runSkillSetup(cmd *cobra.Command, _ []string) error {
|
||||
fmt.Fprintln(out, "已取消。")
|
||||
return nil
|
||||
}
|
||||
} else if mode == skillSetupModeMulti {
|
||||
fmt.Fprintln(errOut, "🧪 multi 模式当前为 EXPERIMENTAL（试验版 / Preview）—— 接口与布局可能变动，稳定版请用 --mode mono")
|
||||
}
|
||||
|
||||
var installed, skipped int
|
||||
@@ -365,10 +361,10 @@ func resolveSkillSetupMode(mode string, autoYes bool, out io.Writer) (string, er
|
||||
huh.NewGroup(
|
||||
huh.NewSelect[string]().
|
||||
Title("选择 dws skill 安装模式").
|
||||
Description("mono = 单 skill 入口（稳定 / 推荐）\nmulti = 按产品拆分（🧪 EXPERIMENTAL / 试验版，未达 stable，接口可能变动）").
|
||||
Description("mono = 单 skill 入口（稳定 / 推荐）\nmulti = 按产品拆分的独立 skill").
|
||||
Options(
|
||||
huh.NewOption("mono — 单 skill（稳定 / 推荐）", skillSetupModeMono),
|
||||
huh.NewOption("multi — 多 skill（🧪 EXPERIMENTAL · 试验版）", skillSetupModeMulti),
|
||||
huh.NewOption("multi — 多 skill（按产品拆分）", skillSetupModeMulti),
|
||||
).
|
||||
Value(&choice),
|
||||
),
|
||||
@@ -526,15 +522,6 @@ func detectExistingAgentHomes(home, mode string) []string {
|
||||
}
|
||||
|
||||
func confirmSkillSetup(out io.Writer, mode, src string, dests []string, multiSkillNames []string) (bool, error) {
|
||||
if mode == skillSetupModeMulti {
|
||||
fmt.Fprintln(out, "\n🧪 ─────────────────────────────────────────────────────────────")
|
||||
fmt.Fprintln(out, " multi 模式当前为 EXPERIMENTAL（试验版 / Preview）")
|
||||
fmt.Fprintf(out, " · 当前选择的 %d 个独立 skill 均跑过 verifier，可用但未达 stable\n", len(multiSkillNames))
|
||||
fmt.Fprintln(out, " · 跨 skill 引用、bundle 命名、目录布局后续可能调整")
|
||||
fmt.Fprintln(out, " · 不建议在生产 / 共享环境直接落地；问题请提 issue 反馈")
|
||||
fmt.Fprintln(out, " 稳定版请用 --mode mono")
|
||||
fmt.Fprintln(out, "🧪 ─────────────────────────────────────────────────────────────")
|
||||
}
|
||||
fmt.Fprintf(out, "\n📦 将安装 skill：\n mode: %s\n source: %s\n", mode, src)
|
||||
if mode == skillSetupModeMulti {
|
||||
fmt.Fprintf(out, " 将装 %d 个独立 skill（按子目录平铺到 <agent-home>/<skill-name>/）：\n", len(multiSkillNames))
|
||||
|
||||
+3
-8
@@ -311,9 +311,8 @@ function Resolve-SkillMode {
|
||||
if ($isInteractive) {
|
||||
Write-Host ""
|
||||
Write-Say "Select skill installation mode:"
|
||||
Write-Say " 1) mono — install one bundled dws skill (stable / recommended)"
|
||||
Write-Say " 2) multi 🧪 EXPERIMENTAL — split each product into its own skill (preview; run 'dws skill setup --mode multi' afterwards)"
|
||||
Write-Say " ⚠ multi is not yet stable — interface, naming and cross-skill references may change"
|
||||
Write-Say " 1) mono — install one bundled dws skill (stable / recommended)"
|
||||
Write-Say " 2) multi — split each product into its own skill (run 'dws skill setup --mode multi' afterwards)"
|
||||
$choice = Read-Host " Choice [1]"
|
||||
switch ($choice) {
|
||||
"" { $script:SkillMode = "mono" }
|
||||
@@ -335,11 +334,7 @@ function Resolve-SkillMode {
|
||||
|
||||
function Write-MultiModeNotice {
|
||||
Write-Say ""
|
||||
Write-Say "🧪 Skill mode: multi (EXPERIMENTAL / preview) — automatic skill install skipped."
|
||||
Write-Say " ⚠ multi is not yet stable. All product-scoped skills pass dispatch verifier,"
|
||||
Write-Say " but interface, naming and cross-skill references may change in future releases."
|
||||
Write-Say " For production / shared environments, use mono mode (--mode mono)."
|
||||
Write-Say ""
|
||||
Write-Say "Skill mode: multi — automatic skill install skipped."
|
||||
Write-Say " To install split skills, run:"
|
||||
Write-Say " $BinName skill setup --mode multi"
|
||||
Write-Say " (One skill per product family; requires the dws binary installed above.)"
|
||||
|
||||
+3
-8
@@ -237,9 +237,8 @@ resolve_skill_mode() {
|
||||
if [ -t 0 ] && [ -t 1 ]; then
|
||||
printf '\n'
|
||||
say "Select skill installation mode:"
|
||||
say " 1) mono — install one bundled dws skill (stable / recommended)"
|
||||
say " 2) multi 🧪 EXPERIMENTAL — split each product into its own skill (preview; run 'dws skill setup --mode multi' afterwards)"
|
||||
say " ⚠ multi is not yet stable — interface, naming and cross-skill references may change"
|
||||
say " 1) mono — install one bundled dws skill (stable / recommended)"
|
||||
say " 2) multi — split each product into its own skill (run 'dws skill setup --mode multi' afterwards)"
|
||||
printf ' Choice [1]: '
|
||||
read choice || choice=""
|
||||
case "$choice" in
|
||||
@@ -259,11 +258,7 @@ resolve_skill_mode() {
|
||||
|
||||
print_multi_mode_notice() {
|
||||
say ""
|
||||
say "🧪 Skill mode: multi (EXPERIMENTAL / preview) — automatic skill install skipped."
|
||||
say " ⚠ multi is not yet stable. All product-scoped skills pass dispatch verifier,"
|
||||
say " but interface, naming and cross-skill references may change in future releases."
|
||||
say " For production / shared environments, use mono mode (--mode mono)."
|
||||
say ""
|
||||
say "Skill mode: multi — automatic skill install skipped."
|
||||
say " To install split skills, run:"
|
||||
say " ${BIN_NAME} skill setup --mode multi"
|
||||
say " (One skill per product family; requires the dws binary installed above.)"
|
||||
|
||||
@@ -1,7 +1,5 @@
|
||||
# Hrbrain（组织大脑）
|
||||
|
||||
> 🧪 **EXPERIMENTAL** — 接口、命名或跨 skill 引用可能调整；以当前 `dws` 二进制与 leaf Schema 为准。问题请提 issue。
|
||||
>
|
||||
> 本文件为 `dingtalk-misc` 内组织大脑产品入口。命令前缀：`dws hrbrain`。Distinct from `dingtalk-contact`（通讯录/组织架构）、考勤（本包 `attendance.md`）。
|
||||
|
||||
## 产品说明
|
||||
|
||||
@@ -1,7 +1,5 @@
|
||||
# Markdown 文件 (markdown) 命令参考
|
||||
|
||||
> 🧪 **EXPERIMENTAL** — 接口、命名或跨 skill 引用可能调整；以当前 `dws` 二进制与 leaf Schema 为准。问题请提 issue。
|
||||
>
|
||||
> 本文件为 `dingtalk-misc` 内原生 Markdown 产品入口。命令前缀：`dws markdown`。Distinct from `dingtalk-doc`（在线富文本文档与块编辑）、`dingtalk-drive`（任意类型文件的一般存储与传输）。
|
||||
|
||||
`markdown` 面向钉盘或文档空间中的原生 `.md` 文件，把内容作为单个纯文本文件读写。在线富文本文档（`adoc`）仍使用 [`dingtalk-doc`](../../dingtalk-doc/references/doc.md)。
|
||||
|
||||
@@ -1,7 +1,5 @@
|
||||
# PAT 行为授权 (pat) 命令参考
|
||||
|
||||
> 🧪 **EXPERIMENTAL** — 接口、命名或跨 skill 引用可能调整；以当前 `dws` 二进制与 leaf Schema 为准。问题请提 issue。
|
||||
>
|
||||
> 本文件为 `dingtalk-misc` 内 PAT 行为授权产品入口。命令前缀：`dws pat`。Distinct from 开放平台应用权限（本包 [devapp.md](./devapp.md)）。
|
||||
|
||||
`dws pat` 管理 Agent 的行为授权。它不管理开放平台应用权限；应用权限使用 `dws dev app permission`（见 [devapp.md](./devapp.md)）。
|
||||
|
||||
@@ -1,7 +1,5 @@
|
||||
# 多组织 / profile
|
||||
|
||||
> 🧪 **EXPERIMENTAL** — 接口、命名或跨 skill 引用可能调整；以当前 `dws` 二进制与 leaf Schema 为准。问题请提 issue。
|
||||
>
|
||||
> 本文件为 `dingtalk-misc` 内多组织 / profile 产品入口。命令前缀：`dws profile` / `dws auth` / 全局 `--profile`。
|
||||
|
||||
dws 可同时登录多个钉钉账号，同一组织也可保留多个账号。一个 profile = 一个 `corpId + userId` 身份；当前 profile 决定本次命令注入哪个身份。
|
||||
|
||||
@@ -1,7 +1,5 @@
|
||||
# skill — DWS 技能管理
|
||||
|
||||
> 🧪 **EXPERIMENTAL** — 接口、命名或跨 skill 引用可能调整；以当前 `dws` 二进制与 leaf Schema 为准。问题请提 issue。
|
||||
>
|
||||
> 这是元能力：只管理 dws 平台上的技能资源。Distinct from `dingtalk-shared`（钉钉产品路由入口）、其他 `dingtalk-*` 产品 skill（执行具体业务能力）、本地 Codex skill 开发。命令前缀：`dws skill`。
|
||||
|
||||
## 意图表
|
||||
|
||||
Reference in New Issue
Block a user