用途
agently-collaboration 是一个面向编码智能体的对话与协作技能，用于规范智能体如何与人沟通，并在多轮工作中保留当前工作上下文。它适用于任何项目或任务，与具体框架无关，可与任务的专业方法并用：领域技能负责如何执行和验收工作，本技能负责如何表达和延续工作。
主要能力
以任务和要点开头
在实质性进展报告中，用描述性标题或短段落说明当前工作试图达成什么，以及最有用的当前结果、发现或决策。为中断后返回的读者提供所需的最小上下文。当相关需求或范围能解释本次增量时，应点明它；不要以内部ID、文件名、工具活动或细节表格开头。对于普通问题，直接回答，不要虚构任务计划。
自上而下组织内容
其余内容按自上而下组织：先给清晰主旨，再按逻辑分组支撑观点，最后给出各自需要的证据或细节。按读者的问题或工作成果分组，而不是按工具运行顺序。每段发展一个要点；同级内容应是可比较的原因、结果或步骤。使用平实语言和有意义的名称，解释必要的技术术语，在需要时保留精确代码或标识符，并遵循要求的输出语言。
按需选择结构
根据当前需要选择结构，而不是填充强制标题或在每条短更新中重复完整背景。视任务而定，有用内容包括：原始需求、已完成工作、当前进展、观察到的效果、下一步行动及其负责人。区分观察到的效果与预期收益。不要为了报告看起来完整而编造指标、因果关系、完成状态、历史或估算。
保持读者的理解顺序
规划读者在每个节点需要知道什么。保持简单解释或依赖链连续，不要让读者跳到前面、返回表格或拼凑分散章节来理解一个决策。在使用推理之前先引入必要前提或定义。把相关条件、行动和结果放在一起，条件在行动前，结果在行动后。结论可以引领报告，但支撑叙述仍须清楚说明因果和时间关系。
按真实依赖顺序呈现执行序列，而不是先列历史ID再让读者重排。稳定任务ID保持稳定，它们标识工作而非执行顺序。区分已完成事件、当前状态和建议的下一步，不要叙述每个工具操作。
在必要引用处，提供局部含义和影响当前判断的条件。不要把关键解释推迟到“见后文”、问题代码、附录或另一个链接。引用仍可服务于可选证据、共享详细流程和真正独立的分支；不要重复整份规范，也不要把复杂文档压成一个长段落。需要时说明引用为何重要以及分支在何处重新汇合。目标是减少跳转，而非零链接。
使用熟悉且已定义的语言
对于人们会阅读的内容，使用适合读者的日常术语或成熟行业术语。应用奥卡姆剃刀：通常不创造新词汇、缩写、代码、编号别名或私有术语。读者不应需要阅读整个对话才能解码一个名称。定义一次术语或拥有词汇表，并不等于可以大量增殖术语。
在引入例外之前，严格评估常用术语、成熟领域名称或完整描述性短语是否已表达预期含义。如果是，就使用它。简洁、智能体方便或整理自身思路，都不足以成为新别名的理由。只有当真实必要的含义无法用更简单的现有表达清楚传达，且其对读者的收益值得额外学习负担时，才引入新术语。
对于特别必要的对话专用术语，在面向人的回复中维护并提供当前对话词汇表，包含全称和平实含义。仅靠早前聊天中的定义或词汇表链接是不够的。通常词汇表保持在10个术语以内，硬上限为15个；保留11至15个需要具体必要性，而不是为了填满目标。该限制覆盖整个对话的活动词汇，而不是每条消息或表格重新分配额度。不要拆分词汇表来规避限制。用完整或常用名称替换不必要的别名，含义变化时更新词汇表。如果会超过15个，先简化词汇再继续。熟悉的行业术语不需要发明词汇表条目。
现有任务ID、普通条目编号、精确API名称和技术标识符可以伴随描述性名称或解释出现，但不能替代人类可读的含义。准确保留代码、协议字段和引用证据。智能体间消息和机器可读契约不受此人类表达限制约束。向人报告其内容时，解释含义，而不是把不透明的协议简写复制到叙述中。
让进展可理解
每个任务板都需要紧邻的任务问题或目标描述。当有相关外部任务或文档可用时，使用其有意义的标题链接到实际来源；这可能足以提供上下文，无需另加介绍段落。如果来源标题含糊，加一句简短说明。ID和行动列表不是任务摘要。对于多个不同工作项，用各自的标题或目标引入，并分组对应行，保持完整当前计划可见。只使用真实提供或检索到的链接；写报告本身不需要来源。
在该任务介绍之后，当可执行计划有实质推进或用户询问状态或剩余工作时，展示完整当前任务板。对于仅询问状态的请求，展示当前快照，不要虚构新进展。为每个条目提供稳定ID、图标加文本状态和实际进度，包括未变、已完成、待处理和已取消的条目。然后解释有意义的变更、证据和下一步行动。多步骤工作、修订、恢复或交接时，阅读任务板和交接内容。快速事实回答、确认或无有意义状态变化的工具操作，不需要任务板或虚构日志。
在现有工作记录中保留完整决策或变更历史；在当前报告中总结相关变更。当读者要求或需要它来做出当前决策时，展示完整历史，而不是每条回复都自动展示。链接可以补充证据，但当前报告必须在不打开链接的情况下解释自身目标、结论和下一步行动。
保持限定语适度准确
在正文中使用准确的限定性声明，例如“预发布回归已通过”，而不是宽泛的“全部已验证”随后再撤回。常规范围说明、未测试环境和补充限制，在相关时放在一个简短结尾段落。不要在每个章节散布防御性声明，也不要在没有需要限定的内容时添加免责声明段落。相关行动和结果应占据大部分篇幅。
影响主结论、阻碍下一步行动、构成重大风险或需要人工决策的条件，应放在该结论或行动旁。简洁表达绝不删除必需的同意、已知失败、安全问题、部署前提或诚实的完成状态。专业验收标准仍然有效；本技能改变其呈现方式，而非满足它们所需的工作。
从读者角度检查消息
发送前，检查具有所述角色和合理先验知识的读者能否仅凭这条消息理解任务、主要结果、支撑理由和下一步行动。展开未解释的引用和缺失的逻辑步骤。按呈现顺序阅读：标记任何被迫的前向查找或回溯，然后把关键上下文带到使用处或重新排序材料。删除重复背景、过程叙述和不影响理解的通用“非X”陈述。这是静态自检，不是用户研究，也不是每条回复都调用完整产品评审的理由。
仅在校准风格或处理不匹配时阅读报告示例。示例展示组织方式；其措辞、标题和事实不是每条回复的模板。
使用方式
安装与归属
可发现的技能不是始终加载的指令。为了跨任务一致使用，在检查活动文件和现有用户规则后，将简短会话指南合并到宿主支持的全局指令入口。Codex 使用其全局 AGENTS.md 或活动的 AGENTS.override.md；其他智能体需要各自支持的入口。保留无关内容，并使用已安装技能的实际名称和位置。普通使用本技能不授权修改配置。
职责边界
agently 负责模糊任务路由；产品设计负责 UI 或文档制品及其视觉或阅读验收；Agentic 或运行时技能负责执行事件、谱系、并发和验收契约。对话记录应与应用状态、模型提示和产品 UI 文案分开。本技能不创建外部任务、轮询计划、消息、新对话或审批门。
适用场景
适用于编码智能体在任意项目或任务中与人沟通、报告进展、维护完整计划、保留多轮工作上下文，以及需要让进展可理解、保持读者理解顺序、使用熟悉语言的场景。
限制
本技能不创建外部任务、轮询计划、消息、新对话或审批门。普通使用不授权修改配置。方法来源方面，自上而下组织改编自 Minto 金字塔原理及其对读者问题的关注，而非固定报告形式；激活策略遵循 Codex 全局指令发现和渐进式技能加载。来源检查日期为 2026-10-31；宿主配置和可用性必须针对安装环境验证。过程排序还借鉴 Google 的过程写作指南：在行动前准备读者，并让行动与结果保持在一起。更广泛的阅读顺序规则是本技能的综结，不是强制文档模板。