菜单
处理 ai-flow super-prompt 顶部「用户提供的上下文文档」一节。 看到这节后、不确定怎么拉取 / 怎么处理 doc 之间的冲突 / text 截断标记是什么意思 / 什么时候不该拉、 请 read 本 skill。适用于 task 下任意 action（plan / build / review / ship / dev）及 chat。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
当你需要写或修改 ai-flow action artifact 文件（actions/<n>-<type>.md）、 不确定该用什么 SDK 工具、参数怎么传、路径写哪、如何跟 submit_work 衔接、 或之前写失败过想看排查清单时——请 `read` 本 skill。任何「写 artifact」场景必读一次。
处理 ai-flow 用户消息里附的图片 / 文件 / 目录。 当用户消息文本里出现 `[ATTACHED_IMAGES]` 或 `[ATTACHED_PATHS]` 标记时、 请 read 本 skill。这两个标记后面跟的是用户希望你跟他的文字消息一起检查的绝对路径列表。
对话创建自定义 Action（把 skill 挂到推进面板）。用户说「建/写/加一个 action」「推进里想有个 XX 动作」「把这个流程做成推进步骤」「对话创建 action」时用本 skill。
创建、修改、完善本平台的 skill（SKILL.md 能力扩展）。只要用户提到「建/写/加/改一个 skill」「把这个流程沉淀成 skill」「让 AI 以后都会做 XX」，即使没说 skill 这个词、只要意图是「沉淀可复用的能力/流程/规范」，都用本 skill。
恢复任务的历史上下文：当用户引用之前的对话（「刚才」「之前」「上次」之类）、 或你怀疑 agent 进程重启过、当前上下文不完整时、用 `read` 工具读任务的 `events.jsonl` 把所需的历史事件找回来。
| name | context-docs-handler |
| description | 处理 ai-flow super-prompt 顶部「用户提供的上下文文档」一节。 看到这节后、不确定怎么拉取 / 怎么处理 doc 之间的冲突 / text 截断标记是什么意思 / 什么时候不该拉、 请 read 本 skill。适用于 task 下任意 action（plan / build / review / ship / dev）及 chat。 |
super-prompt 顶部会出现「用户提供的上下文文档」一节（由 renderContextDocsSection 注入），列出用户在任务详情页上下文面板里加的全部条目。每条 doc 有：
url / path / text / image清单展示形式（举例）：
1. **【飞书 story】**（url）
https://project.feishu.cn/...
2. **【后端技术方案】**（url）
https://wukongedu.feishu.cn/docx/...
3. **【补充说明】**（text、87 字）
补升仅限 status=pending 的任务…
4. **【贴图】**（image、用户截图）
/Users/.../tasks/<id>/uploads/att_xxx.png
→ 用 `read` 工具读这个路径、SDK 会自动转 vision
read 看图| URL 模式 | 推荐工具 | 提炼重点 |
|---|---|---|
project.feishu.cn/.../story/... | 有 feishu-project-mcp 用 get_workitem_brief；没有用内置 meegle CLI | story title / description / 验收标准 / 状态机 / 评论 |
*.feishu.cn/(docx|wiki|sheets|doc)/... 或 wukongedu.feishu.cn/... | 有 feishu-mcp 拉正文；没有用内置 lark-cli | 业务规则 / 文案 / 接口字段 / 状态机 |
含 swagger / api-docs / openapi | shell curl 拿 JSON、自己解 schema | path / method / params / response |
| 其他 http | shell curl 或 SDK fetch | 看内容性质判断 |
绝对路径、用 SDK 内置 read（不是 read_file）。图片自动走 vision；文本 / Markdown / JSON 直接读。
清单里已经 inject 全文、不要重复拉。
若 content 末尾出现「已截断、原文共 N 字、超过 1000 字上限」标记：
actions/<N>-<type>.md）「待澄清 / 不确定项」——用户审阅时可在面板补文档清单已给出截图绝对路径 +「用 read 转 vision」提示——对路径调 read 即可看到像素。
不同 doc 说法对不上时：
actions/<N>-plan.md）加「上下文冲突」节、列两份原文 + 来源assistant_message 里把清单原样贴回用户action 模型是 task 容器 + 任意触发（plan / build / review / ship / dev），产物路径为 data/tasks/<id>/actions/<N>-<type>.md（prompt 里常写相对形式 actions/<N>-<type>.md）。
actions/<N>-plan.md用户可在任务详情页随时加 / 删上下文；当前正在跑的 run 里 super-prompt 已定稿、看不到新加条目。