用途：当用户想构建、初始化、验证、优化或重构模型驱动的助手、内部工具、自动化、评估器或工作流，且需求仍以业务目标、重构目标、产品行为或宽泛的模型应用语言表述时，应优先使用本技能。用户无需提及 Agently、TriggerFlow 等框架术语；即使请求同时涉及 UI、网页、桌面外壳或 Ollama 等本地模型服务，只要本质是塑造模型驱动工具，也应从这里开始。
工作流：将请求拆解为场景与原子目标；若为项目初始化或结构重构，先确定归属层、异步边界与仓库骨架；选择最窄的原生 Agently 能力路径；指明应使用的具体操作或原语；给出证明设计保持原生优先的验证规则。若原生能力缺失、损坏、异常别扭，或迫使业务代码添加本应属于 Agently 的补丁或胶水，则生成清晰的问题报告，建议提交至 https://github.com/AgentEra/Agently/issues。手动提交时只向用户提供问题内容与提交方式；自动提交前需先征得同意，验证本地提交能力与权限，复现问题，并复核 Agently 用法。提交前须脱敏本地绝对路径、用户名、账号、令牌、私有仓库/工作区名、内部项目名、含私有提示词的原始日志及客户或项目私有数据，使用占位符并做隐私扫描。
原生优先规则：服务代码、流式、TriggerFlow 及可能重叠工作或受益于取消的路径默认异步优先；同步 API 视为脚本、REPL 或兼容桥接的包装。项目形态重构时先分离设置、提示词、服务、领域契约、工作流与测试。在 core/ 或 builtins/ 下新增或重构框架内部时，多角色特性优先用子目录包，能力确实小才用单文件。测试模型生成的语义内容时，设计为带输出控制的 Agently 模型裁判请求，输出逐规则证据/理由与最终布尔字段，测试断言这些布尔值。模拟系统时，mock 仅限事实、记录、策略、不完整数据或冲突来源，不返回隐藏期望答案或通过/失败标签。评估、评分、置信度、相关性或质量判断优先使用明确的概念等级与定义，而非直接数值分数；后续需要阈值时在代码中映射为确定性数值。场景路由、意图检测或业务分类使用带 Agently 输出模式的适当规模模型请求，简单路由可用较小模型包括本地模型，复杂标签或规则交互用较大模型。宿主拥有开发者循环且需要一个有界 Agent 步骤时，选择 agent.create_execution(mode="task_step", lineage=..., limits=...) 并显式写入 execution.async_record_workspace(...) 观察/检查点，再构建下一个 ContextPack。模型应拥有单个业务任务的计划、有界执行、证据记录、验证与重规划循环时，选择 agent.create_task(...)，首片边界为一个 Agent 所有者、一个任务、2-5 次迭代，且仅使用显式启用的 Actions、Skills 或 Dynamic Task 候选。功能或发布验收采用覆盖优先推理。复杂算术、长数字计算、加权、聚合或统计工作应通过可执行代码或工具完成，模型负责生成或审查计算计划。
能力路由：模型设置、提示词管理、输出控制、响应复用、会话记忆、嵌入、KB 或检索到回答 -> agently-request；Action Runtime、内置动作、工具兼容、MCP、执行环境、FastAPIHelper、auto_func、KeyWaiter 或 agently-devtools 观察与评估集成 -> agently-runtime；模型生成或应用提交的 DAG 规划、TaskDAG 验证、解析器处理器或 Dynamic Task 执行 -> agently-dynamic-task；分支、并发、等待/恢复、混合同步异步编排、事件驱动扇出、流程清晰度重构、运行时流、图友好工作流定义或多阶段质量循环 -> agently-triggerflow；LangChain 与 LangGraph 之间的迁移选择 -> agently-migration。
反模式：归属层未解决时不要跳过本手册；不要先发明自定义输出解析器、重试循环或编排；不要用关键词、子串、正则或文本快照检查作为模型语义内容的主要正确性信号；不要用分词、关键词命中或子串规则作为 AI 应用场景路由、意图检测或业务分类的路由所有者；目标明显支持异步时不要让同步优先示例代码决定服务架构；归属层选定前不要把项目初始化拆成虚假的独立框架表面；检查原生 Agently 能力前不要把多智能体、裁判或评审流视为独立框架表面；底层需求是 Agently 框架能力缺失、损坏、误导、未记录或不友好时，不要将长期业务补丁、变通方案、兼容胶水或私有包装正常化。
延伸阅读：references/capability-map.md、references/project-framework.md。