@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.
Files changed (30) hide show
  1. package/README.md +8 -17
  2. package/README.zh.md +8 -17
  3. package/bin/people-cli_darwin_amd64 +0 -0
  4. package/bin/people-cli_darwin_arm64 +0 -0
  5. package/bin/people-cli_linux_amd64 +0 -0
  6. package/bin/people-cli_linux_arm64 +0 -0
  7. package/bin/people-cli_windows_amd64.exe +0 -0
  8. package/bin/people-cli_windows_arm64.exe +0 -0
  9. package/package.json +4 -1
  10. package/skills/people-attendance/SKILL.md +0 -667
  11. package/skills/people-attendance/references/people-attendance-submission.md +0 -426
  12. package/skills/people-attendance/scripts/resolve_date.py +0 -894
  13. package/skills/people-hire/SKILL.md +0 -255
  14. package/skills/people-hire/references/people-hire-application.md +0 -334
  15. package/skills/people-hire/references/people-hire-evaluation-task-list.md +0 -233
  16. package/skills/people-hire/references/people-hire-evaluation.md +0 -127
  17. package/skills/people-hire/references/people-hire-interview-record.md +0 -109
  18. package/skills/people-hire/references/people-hire-interview-task-list.md +0 -250
  19. package/skills/people-hire/references/people-hire-interview.md +0 -146
  20. package/skills/people-hire/references/people-hire-job-process.md +0 -93
  21. package/skills/people-hire/references/people-hire-job-requirement.md +0 -227
  22. package/skills/people-hire/references/people-hire-job.md +0 -277
  23. package/skills/people-hire/references/people-hire-minutes.md +0 -91
  24. package/skills/people-hire/references/people-hire-talent.md +0 -105
  25. package/skills/people-hire/references/people-hire-test.md +0 -197
  26. package/skills/people-overtime/SKILL.md +0 -992
  27. package/skills/people-overtime/references/people-attendance-overtime-apply.md +0 -491
  28. package/skills/people-overtime/references/people-attendance-overtime.md +0 -51
  29. package/skills/people-overtime/references/people-attendance-submission.md +0 -203
  30. 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, Attendance, and Hire APIs, and also provides a small set of workflow helper shortcuts such as Drive upload/download.
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, Attendance, Hire, and adjacent workflow helpers
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, leave balances/history, workforce planning, name-to-ID shortcuts |
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 attendance user_approval_over_time list --as user --params '{"check_date_from":"20260401","check_date_to":"20260430","status":"2"}'
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 my leave balances
114
- people-cli attendance +leave-balances --format pretty
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 overtime approvals
126
- people-cli attendance user_approval_over_time list --params '{"check_date_from":"20260401","check_date_to":"20260430","status":"2"}'
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、Attendance、Hire 等 People 域能力,并提供少量配套工作流辅助命令,例如 Drive 文件上传下载。
8
+ 飞书 People 域官方 CLI 工具。`people-cli` 当前覆盖 CoreHR 等 People 域能力,并提供少量配套工作流辅助命令,例如 Drive 文件上传下载。
9
9
 
10
10
  [安装](#安装与快速开始) · [认证](#认证) · [命令](#命令调用体系) · [进阶用法](#进阶用法) · [贡献](#贡献)
11
11
 
12
12
  ## 为什么选 people-cli?
13
13
 
14
- - **聚焦 People 域** — 一套 CLI 覆盖 CoreHR、Attendance、Hire,以及周边工作流辅助能力
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` | 部门查询、员工搜索、员工基本信息、任职信息、待入职查询、假期余额/休假记录、编制查询、名称转 ID 快捷命令 |
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 attendance user_approval_over_time list --as user --params '{"check_date_from":"20260401","check_date_to":"20260430","status":"2"}'
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 attendance +leave-balances --format pretty
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 attendance user_approval_over_time list --params '{"check_date_from":"20260401","check_date_to":"20260430","status":"2"}'
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-beta.3",
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",