@lark-people/cli 0.0.0-beta.3 → 0.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -17
- package/README.zh.md +8 -17
- package/bin/people-cli_darwin_amd64 +0 -0
- package/bin/people-cli_darwin_arm64 +0 -0
- package/bin/people-cli_linux_amd64 +0 -0
- package/bin/people-cli_linux_arm64 +0 -0
- package/bin/people-cli_windows_amd64.exe +0 -0
- package/bin/people-cli_windows_arm64.exe +0 -0
- package/package.json +4 -1
- package/skills/people-attendance/SKILL.md +0 -667
- package/skills/people-attendance/references/people-attendance-submission.md +0 -426
- package/skills/people-attendance/scripts/resolve_date.py +0 -894
- package/skills/people-hire/SKILL.md +0 -255
- package/skills/people-hire/references/people-hire-application.md +0 -334
- package/skills/people-hire/references/people-hire-evaluation-task-list.md +0 -233
- package/skills/people-hire/references/people-hire-evaluation.md +0 -127
- package/skills/people-hire/references/people-hire-interview-record.md +0 -109
- package/skills/people-hire/references/people-hire-interview-task-list.md +0 -250
- package/skills/people-hire/references/people-hire-interview.md +0 -146
- package/skills/people-hire/references/people-hire-job-process.md +0 -93
- package/skills/people-hire/references/people-hire-job-requirement.md +0 -227
- package/skills/people-hire/references/people-hire-job.md +0 -277
- package/skills/people-hire/references/people-hire-minutes.md +0 -91
- package/skills/people-hire/references/people-hire-talent.md +0 -105
- package/skills/people-hire/references/people-hire-test.md +0 -197
- package/skills/people-overtime/SKILL.md +0 -992
- package/skills/people-overtime/references/people-attendance-overtime-apply.md +0 -491
- package/skills/people-overtime/references/people-attendance-overtime.md +0 -51
- package/skills/people-overtime/references/people-attendance-submission.md +0 -203
- package/skills/people-overtime/scripts/resolve_date.py +0 -894
package/README.md
CHANGED
|
@@ -5,13 +5,13 @@
|
|
|
5
5
|
|
|
6
6
|
[中文](./README.zh.md) | [English](./README.md)
|
|
7
7
|
|
|
8
|
-
The official CLI for Feishu People domain workflows. `people-cli` currently covers CoreHR
|
|
8
|
+
The official CLI for Feishu People domain workflows. `people-cli` currently covers CoreHR APIs, and also provides a small set of workflow helper shortcuts such as Drive upload/download.
|
|
9
9
|
|
|
10
10
|
[Install](#installation--quick-start) · [Auth](#authentication) · [Commands](#command-system) · [Advanced](#advanced-usage) · [Contributing](#contributing)
|
|
11
11
|
|
|
12
12
|
## Why people-cli?
|
|
13
13
|
|
|
14
|
-
- **Built for People domains** — one CLI for CoreHR
|
|
14
|
+
- **Built for People domains** — one CLI for CoreHR and adjacent workflow helpers
|
|
15
15
|
- **Shortcut-first, API-complete** — use high-level shortcuts for common tasks, or drop down to generated service commands and raw APIs when needed
|
|
16
16
|
- **AI-friendly output** — structured output and stable command shapes work well for agents and automation
|
|
17
17
|
- **Quick to adopt** — guided config, domain-based auth, and schema introspection shorten time to first successful call
|
|
@@ -22,9 +22,7 @@ The official CLI for Feishu People domain workflows. `people-cli` currently cove
|
|
|
22
22
|
|
|
23
23
|
| Category | Capabilities |
|
|
24
24
|
| --- | --- |
|
|
25
|
-
| `corehr` | Department lookup, employee search, basic info, job data, pre-hire search,
|
|
26
|
-
| `attendance` | Attendance approval and overtime approval queries |
|
|
27
|
-
| `hire` | Hiring data access for jobs, applications, interviews, evaluations, and talent resources |
|
|
25
|
+
| `corehr` | Department lookup, employee search, basic info, job data, pre-hire search, workforce planning, name-to-ID shortcuts |
|
|
28
26
|
| Helpers | Drive file upload/download shortcuts for surrounding workflows |
|
|
29
27
|
|
|
30
28
|
## Installation & Quick Start
|
|
@@ -83,8 +81,6 @@ people-cli auth login
|
|
|
83
81
|
|
|
84
82
|
# Authorize by People domain
|
|
85
83
|
people-cli auth login --domain corehr --recommend
|
|
86
|
-
people-cli auth login --domain attendance
|
|
87
|
-
people-cli auth login --domain hire
|
|
88
84
|
|
|
89
85
|
# Exact scope
|
|
90
86
|
people-cli auth login --scope "corehr:department:read"
|
|
@@ -95,7 +91,7 @@ people-cli auth login --no-wait
|
|
|
95
91
|
people-cli auth login --device-code <DEVICE_CODE>
|
|
96
92
|
|
|
97
93
|
# Identity switching: execute commands as user or bot
|
|
98
|
-
people-cli
|
|
94
|
+
people-cli corehr department list --as user --params '{"page_size":50}'
|
|
99
95
|
```
|
|
100
96
|
|
|
101
97
|
## Command System
|
|
@@ -110,8 +106,8 @@ Prefixed with `+`, designed to be friendly for both humans and AI, with smart de
|
|
|
110
106
|
# Search pre-hires
|
|
111
107
|
people-cli corehr +prehire-search --format table
|
|
112
108
|
|
|
113
|
-
# Query
|
|
114
|
-
people-cli
|
|
109
|
+
# Query employee basic info
|
|
110
|
+
people-cli corehr +employee-basic-info-query --format pretty
|
|
115
111
|
```
|
|
116
112
|
|
|
117
113
|
### 2. API Commands
|
|
@@ -122,11 +118,8 @@ Auto-generated from Feishu OAPI metadata, curated through evaluation and quality
|
|
|
122
118
|
# Search departments
|
|
123
119
|
people-cli corehr department list --params '{"page_size":50}'
|
|
124
120
|
|
|
125
|
-
# Query
|
|
126
|
-
people-cli
|
|
127
|
-
|
|
128
|
-
# Query hiring evaluation tasks
|
|
129
|
-
people-cli hire evaluation_task list --params '{"page_size":10}'
|
|
121
|
+
# Query job change records
|
|
122
|
+
people-cli corehr job_change search --params '{"page_size":10}'
|
|
130
123
|
```
|
|
131
124
|
|
|
132
125
|
### 3. Raw API Calls
|
|
@@ -172,8 +165,6 @@ Use schema to inspect any API method's parameters, request body, response struct
|
|
|
172
165
|
```bash
|
|
173
166
|
people-cli schema
|
|
174
167
|
people-cli schema corehr.job_change.search --format pretty
|
|
175
|
-
people-cli schema attendance.user_approval_over_time.list
|
|
176
|
-
people-cli schema hire.evaluation_task.list
|
|
177
168
|
```
|
|
178
169
|
|
|
179
170
|
### Configuration Management
|
package/README.zh.md
CHANGED
|
@@ -5,13 +5,13 @@
|
|
|
5
5
|
|
|
6
6
|
[中文版](./README.zh.md) | [English](./README.md)
|
|
7
7
|
|
|
8
|
-
飞书 People 域官方 CLI 工具。`people-cli` 当前覆盖 CoreHR
|
|
8
|
+
飞书 People 域官方 CLI 工具。`people-cli` 当前覆盖 CoreHR 等 People 域能力,并提供少量配套工作流辅助命令,例如 Drive 文件上传下载。
|
|
9
9
|
|
|
10
10
|
[安装](#安装与快速开始) · [认证](#认证) · [命令](#命令调用体系) · [进阶用法](#进阶用法) · [贡献](#贡献)
|
|
11
11
|
|
|
12
12
|
## 为什么选 people-cli?
|
|
13
13
|
|
|
14
|
-
- **聚焦 People 域** — 一套 CLI 覆盖 CoreHR
|
|
14
|
+
- **聚焦 People 域** — 一套 CLI 覆盖 CoreHR,以及周边工作流辅助能力
|
|
15
15
|
- **Shortcut 优先,API 完整** — 常见场景优先走高级快捷命令,复杂需求可下钻到服务命令和通用 API
|
|
16
16
|
- **AI 友好** — 结构化输出和稳定命令形态,适合 AI Agent 与自动化集成
|
|
17
17
|
- **上手快** — 引导式配置、按域授权、Schema 自省,缩短从安装到首次成功调用的路径
|
|
@@ -22,9 +22,7 @@
|
|
|
22
22
|
|
|
23
23
|
| 类别 | 能力 |
|
|
24
24
|
| --- | --- |
|
|
25
|
-
| `corehr` |
|
|
26
|
-
| `attendance` | 考勤审批与加班审批记录查询 |
|
|
27
|
-
| `hire` | 招聘职位、投递、面试、评估、人才等招聘数据查询 |
|
|
25
|
+
| `corehr` | 部门查询、员工搜索、员工基本信息、任职信息、待入职查询、编制查询、名称转 ID 快捷命令 |
|
|
28
26
|
| 辅助能力 | Drive 文件上传下载等周边工作流辅助命令 |
|
|
29
27
|
|
|
30
28
|
## 安装与快速开始
|
|
@@ -83,8 +81,6 @@ people-cli auth login
|
|
|
83
81
|
|
|
84
82
|
# 按 People 域授权
|
|
85
83
|
people-cli auth login --domain corehr --recommend
|
|
86
|
-
people-cli auth login --domain attendance
|
|
87
|
-
people-cli auth login --domain hire
|
|
88
84
|
|
|
89
85
|
# 精确 scope
|
|
90
86
|
people-cli auth login --scope "corehr:department:read"
|
|
@@ -95,7 +91,7 @@ people-cli auth login --no-wait
|
|
|
95
91
|
people-cli auth login --device-code <DEVICE_CODE>
|
|
96
92
|
|
|
97
93
|
# 身份切换:以用户或机器人身份执行命令
|
|
98
|
-
people-cli
|
|
94
|
+
people-cli corehr department list --as user --params '{"page_size":50}'
|
|
99
95
|
```
|
|
100
96
|
|
|
101
97
|
## 命令调用体系
|
|
@@ -110,8 +106,8 @@ CLI 提供三种粒度的调用方式,覆盖从快速操作到完全自定义
|
|
|
110
106
|
# 搜索待入职员工
|
|
111
107
|
people-cli corehr +prehire-search --format table
|
|
112
108
|
|
|
113
|
-
#
|
|
114
|
-
people-cli
|
|
109
|
+
# 查询员工基本信息
|
|
110
|
+
people-cli corehr +employee-basic-info-query --format pretty
|
|
115
111
|
```
|
|
116
112
|
|
|
117
113
|
### 2. API 命令
|
|
@@ -122,11 +118,8 @@ people-cli attendance +leave-balances --format pretty
|
|
|
122
118
|
# 获取部门列表
|
|
123
119
|
people-cli corehr department list --params '{"page_size":50}'
|
|
124
120
|
|
|
125
|
-
#
|
|
126
|
-
people-cli
|
|
127
|
-
|
|
128
|
-
# 查询招聘评估任务
|
|
129
|
-
people-cli hire evaluation_task list --params '{"page_size":10}'
|
|
121
|
+
# 查询异动记录
|
|
122
|
+
people-cli corehr job_change search --params '{"page_size":10}'
|
|
130
123
|
```
|
|
131
124
|
|
|
132
125
|
### 3. 通用 API 调用
|
|
@@ -172,8 +165,6 @@ people-cli api POST /open-apis/corehr/v2/common/query_id_by_name --data '{"busin
|
|
|
172
165
|
```bash
|
|
173
166
|
people-cli schema
|
|
174
167
|
people-cli schema corehr.job_change.search --format pretty
|
|
175
|
-
people-cli schema attendance.user_approval_over_time.list
|
|
176
|
-
people-cli schema hire.evaluation_task.list
|
|
177
168
|
```
|
|
178
169
|
|
|
179
170
|
### 配置管理
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lark-people/cli",
|
|
3
|
-
"version": "0.0.0
|
|
3
|
+
"version": "0.0.0",
|
|
4
4
|
"description": "The official CLI for People open platform",
|
|
5
5
|
"bin": {
|
|
6
6
|
"people-cli": "scripts/run.js"
|
|
@@ -33,6 +33,9 @@
|
|
|
33
33
|
"bin/people-cli_*",
|
|
34
34
|
"skills/",
|
|
35
35
|
"!skills/people-skill-maker/",
|
|
36
|
+
"!skills/people-attendance/",
|
|
37
|
+
"!skills/people-overtime/",
|
|
38
|
+
"!skills/people-hire/",
|
|
36
39
|
"scripts/install.js",
|
|
37
40
|
"scripts/install-wizard.js",
|
|
38
41
|
"scripts/run.js",
|