feat: add OKR domain with shortcuts, skill docs, and workflow

internal/registry/service_descriptions.json

@@ -39,6 +39,10 @@
     "en": { "title": "Minutes", "description": "Minutes content and metadata retrieval" },
     "zh": { "title": "妙记", "description": "妙记信息获取、内容查询" }
   },
+  "okr": {
+    "en": { "title": "OKR", "description": "OKR objectives, key results, periods, progress, and review management" },
+    "zh": { "title": "OKR", "description": "OKR 目标、关键结果、周期、进展、复盘管理" }
+  },
   "sheets": {
     "en": { "title": "Sheets", "description": "Spreadsheet operations" },
     "zh": { "title": "电子表格", "description": "电子表格操作" }

shortcuts/okr/okr_get.go

@@ -0,0 +1,150 @@
+// Copyright (c) 2026 Lark Technologies Pte. Ltd.
+// SPDX-License-Identifier: MIT
+
+package okr
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+
+	larkcore "github.com/larksuite/oapi-sdk-go/v3/core"
+
+	"github.com/larksuite/cli/shortcuts/common"
+)
+
+// GetOKR batch-gets OKR details by ID(s).
+var GetOKR = common.Shortcut{
+	Service:     "okr",
+	Command:     "+get",
+	Description: "get OKR details by ID(s)",
+	Risk:        "read",
+	Scopes:      []string{"okr:okr:readonly"},
+	AuthTypes:   []string{"user"},
+	HasFormat:   true,
+
+	Flags: []common.Flag{
+		{Name: "okr-ids", Desc: "comma-separated OKR IDs (max 10)", Required: true},
+		{Name: "lang", Desc: "language: zh_cn or en_us (default zh_cn)", Default: "zh_cn", Enum: []string{"zh_cn", "en_us"}},
+	},
+
+	Validate: func(ctx context.Context, runtime *common.RuntimeContext) error {
+		ids := splitIDs(runtime.Str("okr-ids"))
+		if len(ids) == 0 {
+			return fmt.Errorf("--okr-ids is required")
+		}
+		if len(ids) > 10 {
+			return fmt.Errorf("--okr-ids cannot contain more than 10 IDs (got %d)", len(ids))
+		}
+		return nil
+	},
+
+	DryRun: func(ctx context.Context, runtime *common.RuntimeContext) *common.DryRunAPI {
+		ids := splitIDs(runtime.Str("okr-ids"))
+		params := map[string]interface{}{
+			"okr_ids":      ids,
+			"user_id_type": "open_id",
+			"lang":         runtime.Str("lang"),
+		}
+		return common.NewDryRunAPI().
+			GET("/open-apis/okr/v1/okrs/batch_get").
+			Params(params)
+	},
+
+	Execute: func(ctx context.Context, runtime *common.RuntimeContext) error {
+		ids := splitIDs(runtime.Str("okr-ids"))
+
+		queryParams := make(larkcore.QueryParams)
+		queryParams.Set("user_id_type", "open_id")
+		queryParams.Set("lang", runtime.Str("lang"))
+		for _, id := range ids {
+			queryParams.Add("okr_ids", id)
+		}
+
+		apiResp, err := runtime.DoAPI(&larkcore.ApiReq{
+			HttpMethod:  http.MethodGet,
+			ApiPath:     "/open-apis/okr/v1/okrs/batch_get",
+			QueryParams: queryParams,
+		})
+
+		var result map[string]interface{}
+		if err == nil {
+			if parseErr := json.Unmarshal(apiResp.RawBody, &result); parseErr != nil {
+				return WrapOkrError(ErrCodeOkrInternalError, fmt.Sprintf("failed to parse response: %v", parseErr), "parse OKR batch get response")
+			}
+		}
+
+		data, err := HandleOkrApiResult(result, err, "batch get OKRs")
+		if err != nil {
+			return err
+		}
+
+		okrList, _ := data["okr_list"].([]interface{})
+
+		outData := map[string]interface{}{
+			"okr_list": okrList,
+		}
+
+		runtime.OutFormat(outData, nil, func(w io.Writer) {
+			if len(okrList) == 0 {
+				fmt.Fprintln(w, "No OKRs found for the given IDs.")
+				return
+			}
+
+			for i, item := range okrList {
+				okr, ok := item.(map[string]interface{})
+				if !ok {
+					continue
+				}
+				okrID, _ := okr["id"].(string)
+				name, _ := okr["name"].(string)
+				periodID, _ := okr["period_id"].(string)
+
+				fmt.Fprintf(w, "[%d] OKR: %s\n", i+1, name)
+				fmt.Fprintf(w, "    OKR ID: %s\n", okrID)
+				fmt.Fprintf(w, "    Period ID: %s\n", periodID)
+
+				objectives, _ := okr["objective_list"].([]interface{})
+				for j, obj := range objectives {
+					objective, ok := obj.(map[string]interface{})
+					if !ok {
+						continue
+					}
+					content, _ := objective["content"].(string)
+					objID, _ := objective["id"].(string)
+
+					progressStr := ""
+					if pr, ok := objective["progress_rate"].(map[string]interface{}); ok {
+						progressStr = " " + formatProgressPercent(pr)
+					}
+
+					fmt.Fprintf(w, "\n    O%d: %s%s\n", j+1, content, progressStr)
+					fmt.Fprintf(w, "        Objective ID: %s\n", objID)
+
+					krList, _ := objective["kr_list"].([]interface{})
+					for k, kr := range krList {
+						keyResult, ok := kr.(map[string]interface{})
+						if !ok {
+							continue
+						}
+						krContent, _ := keyResult["content"].(string)
+						krID, _ := keyResult["id"].(string)
+
+						krProgressStr := ""
+						if pr, ok := keyResult["progress_rate"].(map[string]interface{}); ok {
+							krProgressStr = " " + formatProgressPercent(pr)
+						}
+
+						fmt.Fprintf(w, "        KR%d: %s%s\n", k+1, krContent, krProgressStr)
+						fmt.Fprintf(w, "            KR ID: %s\n", krID)
+					}
+				}
+				fmt.Fprintln(w)
+			}
+		})
+
+		return nil
+	},
+}

shortcuts/okr/okr_get_test.go

@@ -0,0 +1,101 @@
+// Copyright (c) 2026 Lark Technologies Pte. Ltd.
+// SPDX-License-Identifier: MIT
+
+package okr
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/larksuite/cli/internal/httpmock"
+)
+
+func TestGetOKR(t *testing.T) {
+	tests := []struct {
+		name           string
+		okrIDs         string
+		formatFlag     string
+		expectedOutput []string
+	}{
+		{
+			name:       "single ID pretty",
+			okrIDs:     "okr-001",
+			formatFlag: "pretty",
+			expectedOutput: []string{
+				"OKR: Test OKR",
+				"OKR ID: okr-001",
+				"O1: Grow the team",
+			},
+		},
+		{
+			name:       "single ID json",
+			okrIDs:     "okr-001",
+			formatFlag: "json",
+			expectedOutput: []string{
+				`"okr_list"`,
+				`"okr-001"`,
+			},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			f, stdout, _, reg := okrShortcutTestFactory(t)
+			warmTenantToken(t, f, reg)
+
+			reg.Register(&httpmock.Stub{
+				Method: "GET",
+				URL:    "/open-apis/okr/v1/okrs/batch_get",
+				Body: map[string]interface{}{
+					"code": 0, "msg": "success",
+					"data": map[string]interface{}{
+						"okr_list": []interface{}{
+							map[string]interface{}{
+								"id":        "okr-001",
+								"name":      "Test OKR",
+								"period_id": "period-001",
+								"objective_list": []interface{}{
+									map[string]interface{}{
+										"id":      "obj-001",
+										"content": "Grow the team",
+										"kr_list": []interface{}{},
+									},
+								},
+							},
+						},
+					},
+				},
+			})
+
+			shortcut := GetOKR
+			shortcut.AuthTypes = []string{"user", "bot"}
+
+			err := runMountedOkrShortcut(t, shortcut, []string{"+get", "--okr-ids", tt.okrIDs, "--format", tt.formatFlag, "--as", "bot"}, f, stdout)
+			if err != nil {
+				t.Fatalf("expected no error, got %v", err)
+			}
+
+			out := stdout.String()
+			for _, expected := range tt.expectedOutput {
+				if !strings.Contains(out, expected) {
+					t.Errorf("output missing expected string (%s), got: %s", expected, out)
+				}
+			}
+		})
+	}
+}
+
+func TestGetOKRValidation(t *testing.T) {
+	t.Run("too many IDs", func(t *testing.T) {
+		f, stdout, _, reg := okrShortcutTestFactory(t)
+		warmTenantToken(t, f, reg)
+
+		shortcut := GetOKR
+		shortcut.AuthTypes = []string{"user", "bot"}
+
+		err := runMountedOkrShortcut(t, shortcut, []string{"+get", "--okr-ids", "1,2,3,4,5,6,7,8,9,10,11", "--as", "bot"}, f, stdout)
+		if err == nil {
+			t.Fatal("expected validation error for too many IDs")
+		}
+	})
+}