clickup-issue-create

在 ClickUp 中创建任务

将当前输入或用户指定的历史记录转换为 ClickUp 任务。创建所请求的结构，但不要实现解决方案、修改项目文件、启动时间追踪或推进状态。

持续维护文档

如果创建的任务要求修改 ClickUpfy，请在任务正文中加入文档部分，列出受影响的 docs/user/ 章节、受影响的 CLI 或 MCP 参考文档、docs/user/reading-order.txt 的更新、电子书版本，以及命令 npm run ebook 和 npm run ebook:verify。对于新增或变更的每个命令或 MCP 工具，请注明需要说明所有参数、返回值、权限、限制和五个不同的示例。

不要将 README、帮助文本、变更日志或测试视为用户手册的替代品。如果变更不会改变公共接口，请在任务中声明这一限制，以免产生推测性文档。

限制

• 仅使用来源中包含的事实和要求。
• 保留原意、限制、示例和验收条件。
• 不得编造期限、负责人、优先级、状态、测试或子任务。
• 不得修改收到的来源或编辑代码库。
• 创建任务时不得处理清单项目。
• 从将发送到 ClickUp 的版本中删除凭据、令牌、个人数据和已签名 URL。告知用户已省略这些内容。
• 缺少标题或某项选择会实质性改变结构时，创建前应先请求澄清。

工具

使用项目的 MCP：

• 使用 clickupfy_mcp_context 确认 account 和 List。
• 使用 clickupfy_tasks_search 检测可能的重复项。
• 使用 clickupfy_task_create 和 markdownContent 创建任务和子任务。
• 使用 clickupfy_checklist_create 创建清单。
• 使用 clickupfy_checklist_item_create 添加每项测试。
• 使用 clickupfy_task_get 验证创建的任务树。

仅当 MCP 不可用时，才使用等效的 CLI：

clickupfy task create \
  --list <list-id> \
  --name "<título>" \
  --markdown-content "<markdown>"

clickupfy checklist create <task-id> --name "Testes"
clickupfy checklist item-create <checklist-id> --name "<teste>"

解读来源

使用当前消息、对话历史或用户明确指定的材料。如果输入已经是完整的任务 Markdown，则将其保留为 markdownContent。否则，在不改变含义的前提下整理内容：

# <título>

## Resultado esperado

<resultado descrito na fonte>

## Escopo

<entregas e limites explícitos>

## Requisitos

- <requisito verificável>

## Condições de aprovação

- <condição informada>

## Referências

- <links e artefatos seguros>

任务名称填写在 name 字段中。如果来源中没有 H1，则无需重复添加。仅在存在实际内容时保留相应章节。

只有当来源声明了需要单独跟进的工作单元、层级关系或依赖关系时，才将其识别为子任务。保留嵌套子任务之间的父子关系。

当来源将内容称为测试、自动化验证或可验证场景时，将其识别为测试。在所属任务中创建名为 Testes 的清单，并为每项测试创建一个清单项目。不属于测试的验收条件应保留在 Markdown 正文中，不得推断并将其转换为清单项目。

展示创建计划

首次写入前，先在对话中展示：

• 标题和目标 List。
• 将创建的 Markdown 章节。
• 完整的子任务树。
• 每个任务的清单及其项目。
• 来源中明确提供的可选字段。

存在实质性歧义时，不得创建任何内容。如果结构明确无误，则在展示计划后继续操作，无需请求重复确认。

创建和验证

按顺序执行：

1. 调用 clickupfy_mcp_context 并确认 List。
2. 搜索完全一致的标题。如果已存在可能等效的任务，展示匹配结果，并请用户选择复用该任务还是创建新任务。
3. 使用 markdownContent 创建主任务。
4. 在同一个 List 中按层级创建每个子任务，并在 parent 字段中传入父任务 ID。
5. 在对应任务中创建名为 Testes 的清单，并添加每个尚未完成的项目。
6. 调用 clickupfy_task_get 获取根任务，并将已保存的任务树与展示的计划进行比较。
7. 如果根任务的响应未包含完整的 Markdown 正文，则逐一重新读取每个子任务。

不要通过删除已创建的任务来弥补失败。说明已保存的 ID、确切的失败位置，以及其余未创建的内容。

交付

回复以下内容：

• 主任务的 ID、名称和链接。
• 子任务的 ID 和层级结构。
• 清单及其项目数量。
• 确认正文已保存为 Markdown。
• 出于安全原因省略的任何部分，或因失败而未完成的部分。

不要将评论添加到任务中，不要启动计时器、修改状态或将清单项目标记为已完成，以免产生本技能的副作用。