makecindy / makecindy/cindy

Cindy 会话需注册 Codex Spreadsheets 运行时工具以支持 Excel 文件创建

Open
#1,633 0 comments 0 reactions 0 assignees View on GitHub
feature
Dominant language
TypeScript
Stars
2.7k
Forks
401
Avg merge
21h 48m
Merged PRs (30d)
776

Description

**提交人**: XinzheZhou
**客户端版本**: 0.1.28

---

## 使用场景

用户希望直接让 Cindy 创建 Excel 配置表。会话能够识别 Spreadsheets 相关能力,但其依赖的 Codex Spreadsheets 运行时工具没有被注册到 Cindy 会话中,因此无法实际创建或编辑工作簿。

典型触发方式:

1. 用户向 Cindy 提出“帮我创建一份 Excel 配置表”之类的请求。
2. Cindy 尝试使用 Spreadsheets 能力处理该任务。
3. 由于对应的 Codex 运行时工具未注册到当前会话,任务无法继续完成。

## 诉求

当 Cindy 会话提供或启用 Codex Spreadsheets 能力时,应同时接入并注册该能力依赖的运行时工具,使 Agent 能够真正执行电子表格文件的创建、编辑和校验,而不只是看到技能说明。

期望结果:

- 用户提出创建 Excel 配置表的请求后,Cindy 可以调用 Spreadsheets 运行时工具并生成可用的 `.xlsx` 文件。
- 后续能够继续修改表格内容、公式与格式,并对产物进行必要校验。
- 不再出现“Spreadsheets 技能可见,但底层工具未注册、无法调用”的能力断层。

## 建议方案

- 在 Cindy 构建会话工具注册表时,识别 Codex Spreadsheets 技能依赖的运行时工具,并与技能一并注册。
- 如果采用按需加载,则在 Spreadsheets 技能被选择或首次调用前完成工具注册,保证调用链路连续。
- 当依赖工具确实不可用时,返回明确的能力缺失提示,便于定位是工具注册问题,而不是表格任务本身失败。

建议验收标准:在一个新建 Cindy 会话中请求创建 Excel 配置表,Agent 能成功调用对应运行时工具,生成并校验 `.xlsx` 文件;随后可继续完成一次内容或格式修改。
---
**版本区域**: CN
**OS**: win32 x64 (10.0.26100)
**界面语言**: zh-CN

Contributor guide

Open the contributing guide

Research direction

Trace Cindy's session tool registry and the integration point where the Codex Spreadsheets skill is exposed. Reproduce the Excel configuration-table request in a new session, then verify that the dependent runtime tool is registered, an .xlsx file is created and validated, and one content or formatting change can be completed; also check the unavailable-tool error path.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.