agently-task-dev

Agently Task Dev

Overview

把“用 Agently 开发任务/工作流”标准化成可回归的工程流程：先最小可运行，再逐步叠加 Agently 的能力（结构化输出、流式输出、工具、TriggerFlow、KB、MCP、服务化），并用能力清单做回归检查，避免遗漏与“重造轮子”。

这里的“通用”指 Agently 框架用法的通用性：不把方法论绑定到某个业务任务（写文章/写总结/写代码）上，而是覆盖 Agently 的能力面与工程化交付流程。

When To Use / When NOT To Use

适用：

• 你要写 Agently 任务/工作流，并且需要可回归测试（离线 stub + 可选真模型集成）。
• 你明确需要：schema + ensure_keys、delta/instant/streaming_parse、Search/Browse、TriggerFlow、ChromaDB、MCP、SSE/WS/HTTP 任意一项。

不适用（或应先确认再用）：

• 用户没有要用 Agently（只是泛泛讨论 streaming/tests），或明确说“不用 Agently”。
• 你只要“写个 prompt/纯文本输出”，不关心测试、结构化输出、streaming 或工具。
• 当前环境无法 import agently（需要先解决依赖环境）。

Read This First (Your TDD Definition)

你要求的“测试驱动”不是写文档，而是：

1. 写任务的同时写测试（回归测试是交付物的一部分）
2. 用 Agently 的输出/事件流来测可用性（schema/ensure_keys、instant streaming、SSE 等）
3. 测试通过才算任务交付成功；否则不允许宣称“用 agently-task-dev 开发的任务没问题”

本 skill 自带 3 份“验收与回归”材料（用它们驱动开发）：

• 任务契约（接口约定）：references/task-contract.md
• 测试策略（离线回归 + 真模型集成）：references/testing-strategy.md
• 能力清单（不遗漏准绳）：references/capability-inventory.md

另外提供若干份“可复用最佳实践”材料（避免踩坑、提升可迁移性）：

• Streaming UX（打字机 + 高性能 + 回归护栏）：references/streaming-ux-playbook.md
• Common Pitfalls（通用排障）：references/common-pitfalls.md
• OpenAICompatible 配置与鉴权 cookbook：references/openai-compatible-settings-cookbook.md
• Configure Prompt（YAML/JSON 模板化）：references/configure-prompt-guide.md
• Auto Loop（plan→tool→final）与 guardrails：references/auto-loop-patterns.md
• Response/Result & streaming 速查表：references/response-result-cheatsheet.md
• Settings & Prompt 结构化（全局/实例、slots/mappings、schema 顺序）：references/settings-and-prompt-structure.md
• Advanced Integrations（MCP/ChatSession/Attachment/Blueprint/运维）：references/advanced-integrations.md
• *CAP 覆盖索引（CAP- → skill 落点）**：references/capability-coverage-map.md

最短闭环（推荐）：

1. 用脚手架生成 task + tests（见下方 Quick Start）
2. 先跑离线回归（不需要 key、稳定可重复）
3. 必要时再开真模型集成测试（可选，依赖 key）

---

Quick Start: Scaffold Task + Regression Tests

用脚手架一次性生成“任务 + 测试 + OpenAI-compatible stub（离线）”：