Skip to content

feat(task): add resource agent & agent_task_step_info#693

Merged
liangshuo-1 merged 1 commit intolarksuite:mainfrom
bytedance-zxy:feat-aliy-tas
Apr 29, 2026
Merged

feat(task): add resource agent & agent_task_step_info#693
liangshuo-1 merged 1 commit intolarksuite:mainfrom
bytedance-zxy:feat-aliy-tas

Conversation

@bytedance-zxy
Copy link
Copy Markdown
Contributor

@bytedance-zxy bytedance-zxy commented Apr 28, 2026

feat(task): add agent and agent_task_step_info API resources to SKILL.md

Add documentation for new task API resources:

  • agent: update_agent_profile (update AI agent profile content), register_agent (register/unregister AI agents)
  • agent_task_step_info: append_task_steps (write task records)

Also add corresponding scope permissions to the permission table.

Summary by CodeRabbit

  • Documentation

    • Expanded Lark Task skill docs with new API references, updated permissions table, and coverage of agent registration/unregistration, profile updates, and task-record updates.
  • New Features

    • Register and unregister AI agents, update agent profiles, and record/append agent task steps.

@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Apr 28, 2026

CLA assistant check
All committers have signed the CLA.

@github-actions github-actions Bot added domain/task PR touches the task domain size/M Single-domain feat or fix with limited business impact labels Apr 28, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 28, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9dc2bfe5-ae7a-4202-a538-5ab2c82a9f03

📥 Commits

Reviewing files that changed from the base of the PR and between e598c1b and b0daeee.

📒 Files selected for processing (1)
  • skills/lark-task/SKILL.md
✅ Files skipped from review due to trivial changes (1)
  • skills/lark-task/SKILL.md

📝 Walkthrough

Walkthrough

Updated skills/lark-task/SKILL.md to document task-agent functionality: agent registration/unregistration, agent homepage-data updates, and writing agent task records. Added CLI API resource sections for agent and agent_task_step_info, and updated the permissions table mapping new methods to task:task:write.

Changes

Cohort / File(s) Summary
Lark-Task Skill Documentation
skills/lark-task/SKILL.md
Expanded top-level description to include agent registration/unregistration, homepage-data updates, and agent task records; added agent resource with update_agent_profile and register_agent; added agent_task_step_info resource with append_task_steps; updated permissions/scope table to include task:task:write for these methods.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Suggested reviewers

  • zero-my
  • tengchengwei

Poem

🐰 I hopped through lines and added three,
Profiles, register, and steps for me,
Permissions tucked in neat and tight,
Docs now shine a little bright,
A rabbit twitches — all set right!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description covers the main changes but lacks Test Plan section and Related Issues section as specified in the template. Add Test Plan section (with checklist items for unit tests and manual verification) and Related Issues section to match the repository's pull request template.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: adding documentation for two new task-related API resources (agent and agent_task_step_info).
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
Review rate limit: 7/8 reviews remaining, refill in 7 minutes and 30 seconds.

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
skills/lark-task/SKILL.md (1)

161-164: ⚠️ Potential issue | 🔴 Critical

Add missing authoritative scope definitions for agent methods.

The three new methods (agent.update_agent_profile, agent.register_agent, agent_task_step_info.append_task_steps) are documented in the SKILL.md permission table with task:task:write scope, but they have no entries in the authoritative scope registries (scope_priorities.json, scope_overrides.json, or meta_data_default.json).

Without these definitions, CLI auth will not recognize these scopes and the feature will fail at runtime. Either add the scope definitions to the registry files or remove these rows from the documentation table if they are not yet implemented.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@skills/lark-task/SKILL.md` around lines 161 - 164, The SKILL.md adds three
new methods (agent.update_agent_profile, agent.register_agent,
agent_task_step_info.append_task_steps) but they are missing authoritative scope
entries; add corresponding scope definitions for "task:task:write" to your scope
registries (scope_priorities.json, scope_overrides.json, and
meta_data_default.json) so CLI auth recognizes them — specifically, add entries
mapping each method symbol to the "task:task:write" scope in
scope_priorities.json (with appropriate priority), include any required override
entries in scope_overrides.json, and add default metadata entries in
meta_data_default.json; alternatively, if these methods aren’t implemented yet,
remove the three rows from SKILL.md instead of modifying the registries.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@skills/lark-task/SKILL.md`:
- Around line 117-121: The bullet entries for the agent methods include an H2
markdown token ("## 功能介绍") inside list items which breaks rendering; edit the
`update_agent_profile` and `register_agent` entries to remove the "## 功能介绍"
heading and convert it into inline explanatory text (e.g. "功能介绍:更新任务代理的主页内容数据。"
or move a single "功能介绍" heading above the agent list) so the list items remain
normal bullets and descriptions render correctly.

---

Outside diff comments:
In `@skills/lark-task/SKILL.md`:
- Around line 161-164: The SKILL.md adds three new methods
(agent.update_agent_profile, agent.register_agent,
agent_task_step_info.append_task_steps) but they are missing authoritative scope
entries; add corresponding scope definitions for "task:task:write" to your scope
registries (scope_priorities.json, scope_overrides.json, and
meta_data_default.json) so CLI auth recognizes them — specifically, add entries
mapping each method symbol to the "task:task:write" scope in
scope_priorities.json (with appropriate priority), include any required override
entries in scope_overrides.json, and add default metadata entries in
meta_data_default.json; alternatively, if these methods aren’t implemented yet,
remove the three rows from SKILL.md instead of modifying the registries.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 497dbc98-0b18-4058-b9ec-2b198d441d97

📥 Commits

Reviewing files that changed from the base of the PR and between b8d0f96 and f6e5a44.

📒 Files selected for processing (1)
  • skills/lark-task/SKILL.md

Comment thread skills/lark-task/SKILL.md
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

♻️ Duplicate comments (1)
skills/lark-task/SKILL.md (1)

119-120: ⚠️ Potential issue | 🟡 Minor

Remove ## heading tokens from list item descriptions.

At Line 119 and Line 124, embedding ## 功能介绍 inside bullets introduces heading syntax in list content. Keep these as plain inline descriptions.

🛠️ Suggested doc fix
-  - `update_agent_profile` — ## 功能介绍 更新任务代理的主页内容数据。
+  - `update_agent_profile` — 功能介绍:更新任务代理的主页内容数据。
   - `register_agent` — 注册/注销 AI 智能体
@@
-  - `append_task_steps` — ## 功能介绍 写入任务记录。
+  - `append_task_steps` — 功能介绍:写入任务记录。

Also applies to: 124-124

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@skills/lark-task/SKILL.md` around lines 119 - 120, Remove the accidental
markdown heading tokens inside the list items for update_agent_profile and
register_agent: change entries that read like "`update_agent_profile` — ## 功能介绍
更新任务代理的主页内容数据。" and "`register_agent` — 注册/注销 AI 智能体" (if it contains `##`) to
plain inline descriptions without the "##" token so they read e.g.
"`update_agent_profile` — 功能介绍 更新任务代理的主页内容数据。" and "`register_agent` — 注册/注销 AI
智能体`", ensuring no heading syntax remains in the bullet text.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@skills/lark-task/SKILL.md`:
- Around line 119-120: Remove the accidental markdown heading tokens inside the
list items for update_agent_profile and register_agent: change entries that read
like "`update_agent_profile` — ## 功能介绍 更新任务代理的主页内容数据。" and "`register_agent` —
注册/注销 AI 智能体" (if it contains `##`) to plain inline descriptions without the
"##" token so they read e.g. "`update_agent_profile` — 功能介绍 更新任务代理的主页内容数据。" and
"`register_agent` — 注册/注销 AI 智能体`", ensuring no heading syntax remains in the
bullet text.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5a1e038a-16cd-4865-8257-b51aa46a576e

📥 Commits

Reviewing files that changed from the base of the PR and between f6e5a44 and 45df9bb.

📒 Files selected for processing (1)
  • skills/lark-task/SKILL.md

Change-Id: I3b2d8ee72361aee9b68a5bbbafcf594f220d3105
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 29, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 64.14%. Comparing base (05d8137) to head (b0daeee).
⚠️ Report is 24 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #693      +/-   ##
==========================================
+ Coverage   63.10%   64.14%   +1.03%     
==========================================
  Files         437      504      +67     
  Lines       38927    44285    +5358     
==========================================
+ Hits        24565    28406    +3841     
- Misses      12187    13411    +1224     
- Partials     2175     2468     +293     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@github-actions
Copy link
Copy Markdown

🚀 PR Preview Install Guide

🧰 CLI update

npm i -g https://pkg.pr.new/larksuite/cli/@larksuite/cli@b0daeee227ad69ba29c8d912a64b27f71001c823

🧩 Skill update

npx skills add bytedance-zxy/cli#feat-aliy-tas -y -g

@liangshuo-1 liangshuo-1 merged commit 082275f into larksuite:main Apr 29, 2026
19 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

domain/task PR touches the task domain size/M Single-domain feat or fix with limited business impact

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants