@downcity/plugins 1.0.4

package/src/task/Action.ts

@@ -0,0 +1,491 @@
+/**
+ * Task command services.
+ *
+ * 关键点（中文）
+ * - 任务定义（task.md）与执行（runTaskNow）统一收口到服务层
+ * - CLI 与 Server 共用同一份参数归一化/校验逻辑
+ */
+
+import path from "node:path";
+import type { ShipTaskStatus } from "./types/Task.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+import {
+  deriveTaskIdFromTitle,
+  normalizeTaskId,
+} from "./runtime/Paths.js";
+import {
+  normalizeTaskKind,
+  normalizeTaskWhen,
+  normalizeTaskStatus,
+} from "./runtime/Model.js";
+import {
+  deleteTask,
+  listTasks,
+  readTask,
+  resolveTaskIdByTitle,
+  writeTask,
+} from "./runtime/Store.js";
+import { runTaskNow } from "./runtime/Runner.js";
+import type {
+  TaskCreateRequest,
+  TaskCreateResponse,
+  TaskDeleteRequest,
+  TaskDeleteResponse,
+  TaskListResponse,
+  TaskRunRequest,
+  TaskRunResponse,
+  TaskUpdateRequest,
+  TaskUpdateResponse,
+  TaskSetStatusRequest,
+  TaskSetStatusResponse,
+} from "./types/TaskCommand.js";
+
+function resolveTaskStatus(input: JsonValue | undefined, fallback: ShipTaskStatus): ShipTaskStatus {
+  const normalized = normalizeTaskStatus(input);
+  return normalized || fallback;
+}
+
+const TASK_LOG_PREFIX = "[TASK]";
+
+function formatTaskLogMessage(message: string): string {
+  return `${TASK_LOG_PREFIX} ${message}`;
+}
+
+function buildDefaultTaskBody(): string {
+  return [
+    "# 任务目标",
+    "",
+    "- 明确这次任务最终要交付什么结果，最终回复会由系统自动发送到任务绑定的 chat。",
+    "- 如果需要额外文件，请写入本次 run 目录，便于审计和排查。",
+    "",
+    "# 背景与输入",
+    "",
+    "- 补充任务依赖的上下文、数据来源、范围限制与关键假设。",
+    "- 如果存在用户原话、链接、文件路径或口径要求，在这里写清楚。",
+    "",
+    "# 执行步骤",
+    "",
+    "1. 先理解任务目标与完成标准。",
+    "2. 按需要收集信息、执行分析或运行命令。",
+    "3. 把关键中间产物写入 run 目录。",
+    "4. 整理出面向用户可直接阅读的最终结果。",
+    "",
+    "# 输出要求",
+    "",
+    "- 最终输出直接写结果本身，不要包多余寒暄，不要粘贴冗长日志。",
+    "- 需要结构时，优先使用短标题、要点列表、表格或 JSON 等稳定格式。",
+    "- 默认不要在正文里重复调用 `city chat send`；系统会自动发送最终结果。",
+    "",
+    "# 触发与状态建议",
+    "",
+    "- 默认创建后会立即启用；如果还在试运行或需要人工确认，再改成 `paused`。",
+    "- 已经稳定、需要周期执行的任务：优先保持 `enabled`，再改成 cron。",
+    "- 一次性定时任务：使用 `time:<带时区的 ISO 时间>`；执行后会自动回退为 `@manual` + `paused`。",
+    "",
+    "# 注意事项",
+    "",
+    "- 当前是独立 task 上下文，不要假设仍处在原始聊天回合里。",
+    "- 尽量使用可审计的方式：关键中间产物写入 `./.downcity/task/<title>/<timestamp>/` 下的 markdown 文件。",
+    "- 如果任务明确要求跨会话、跨平台或发送额外通知，再显式调用 `city chat send`。",
+    "",
+  ].join("\n");
+}
+
+
+export async function listTaskDefinitions(params: {
+  projectRoot: string;
+  status?: ShipTaskStatus;
+}): Promise<TaskListResponse> {
+  const root = path.resolve(params.projectRoot);
+  const normalizedStatus = normalizeTaskStatus(params.status);
+
+  const tasks = await listTasks(root);
+  const filtered = normalizedStatus
+    ? tasks.filter((task) => String(task.status).toLowerCase() === normalizedStatus)
+    : tasks;
+
+  return {
+    success: true,
+    tasks: filtered.map((task) => ({
+      title: task.title,
+      description: task.description,
+      ...(typeof task.body === "string" && task.body.trim()
+        ? { body: task.body }
+        : {}),
+      when: task.when,
+      status: task.status,
+      sessionId: task.sessionId,
+      kind: task.kind || "agent",
+      ...(task.kind === "agent" ? { review: Boolean(task.review) } : {}),
+      taskMdPath: task.taskMdPath,
+      ...(task.lastRunTimestamp ? { lastRunTimestamp: task.lastRunTimestamp } : {}),
+    })),
+  };
+}
+
+export async function createTaskDefinition(params: {
+  projectRoot: string;
+  request: TaskCreateRequest;
+}): Promise<TaskCreateResponse> {
+  const root = path.resolve(params.projectRoot);
+  const req = params.request;
+
+  const title = String(req.title || "").trim();
+  const description = String(req.description || "").trim();
+  let taskIdFromName = "";
+  let taskId = "";
+  try {
+    taskIdFromName = deriveTaskIdFromTitle(title);
+    taskId = normalizeTaskId(taskIdFromName);
+  } catch (error) {
+    return {
+      success: false,
+      error: String(error),
+    };
+  }
+  const whenNormalized = normalizeTaskWhen(String(req.when || "@manual").trim() || "@manual");
+  const sessionId = String(req.sessionId || "").trim();
+  const kind = normalizeTaskKind(req.kind);
+
+  if (!title) return { success: false, error: "Missing title" };
+  if (!description) return { success: false, error: "Missing description" };
+  if (!sessionId) return { success: false, error: "Missing sessionId" };
+  if (!whenNormalized.ok) return { success: false, error: whenNormalized.error };
+
+  const status = resolveTaskStatus(req.status, "enabled");
+  const body =
+    typeof req.body === "string" && req.body.trim()
+      ? req.body.trim()
+      : kind === "script"
+        ? ""
+        : buildDefaultTaskBody();
+  // 关键点（中文）：`title` 是唯一键，create 去重只按 title 精确匹配。
+  const existingTasks = await listTasks(root);
+  const duplicated = existingTasks.find((item) => String(item.title || "").trim() === title);
+  if (duplicated && !req.overwrite) {
+    return {
+      success: true,
+      title: duplicated.title,
+      taskMdPath: duplicated.taskMdPath,
+      reusedExisting: true,
+      message: "Task title already exists; reused existing task.",
+    };
+  }
+  const targetTaskId = duplicated ? duplicated.taskId : taskId;
+
+  try {
+    const written = await writeTask({
+      taskId: targetTaskId,
+      projectRoot: root,
+      overwrite: Boolean(req.overwrite) || Boolean(duplicated),
+      frontmatter: {
+        title,
+        description,
+        when: whenNormalized.value,
+        sessionId,
+        kind,
+        ...(kind === "agent" && req.review === true ? { review: true } : {}),
+        status,
+      },
+      body,
+    });
+
+    return {
+      success: true,
+      title,
+      taskMdPath: written.taskMdPath,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: String(error),
+    };
+  }
+}
+
+export async function updateTaskDefinition(params: {
+  projectRoot: string;
+  request: TaskUpdateRequest;
+}): Promise<TaskUpdateResponse> {
+  const root = path.resolve(params.projectRoot);
+  const req = params.request;
+  const title = String(req.title || "").trim();
+  let taskId = "";
+  try {
+    taskId = await resolveTaskIdByTitle({ projectRoot: root, title });
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+
+  // 关键点（中文）：API 层也做一次互斥校验，避免非 CLI 调用写入歧义状态。
+  if (req.body !== undefined && req.clearBody) {
+    return { success: false, error: "`body` conflicts with `clearBody`" };
+  }
+  if (req.when !== undefined && req.clearWhen) {
+    return { success: false, error: "`when` conflicts with `clearWhen`" };
+  }
+
+  try {
+    const current = await readTask({
+      projectRoot: root,
+      taskId,
+    });
+
+    const nextTitle =
+      typeof req.titleNext === "string"
+        ? req.titleNext.trim()
+        : current.frontmatter.title;
+    if (!nextTitle) return { success: false, error: "title cannot be empty" };
+    const nextTaskId = normalizeTaskId(deriveTaskIdFromTitle(nextTitle));
+    if (nextTaskId !== taskId) {
+      return {
+        success: false,
+        error: `title cannot change task identity. Expected "${taskId}", got "${nextTaskId}".`,
+      };
+    }
+
+    const description =
+      typeof req.description === "string"
+        ? req.description.trim()
+        : current.frontmatter.description;
+    if (!description) return { success: false, error: "description cannot be empty" };
+
+    const whenInput = req.clearWhen
+      ? "@manual"
+      : typeof req.when === "string"
+        ? req.when.trim()
+        : current.frontmatter.when;
+    const whenNormalized = normalizeTaskWhen(whenInput);
+    if (!whenNormalized.ok) return { success: false, error: whenNormalized.error };
+
+    const sessionId =
+      typeof req.sessionId === "string" ? req.sessionId.trim() : current.frontmatter.sessionId;
+    if (!sessionId) return { success: false, error: "sessionId cannot be empty" };
+    const kind = normalizeTaskKind(
+      req.kind === undefined ? current.frontmatter.kind : req.kind,
+    );
+    const review =
+      kind === "agent"
+        ? req.review === undefined
+          ? Boolean(current.frontmatter.review)
+          : req.review === true
+        : false;
+
+    const status =
+      req.status === undefined
+        ? current.frontmatter.status
+        : normalizeTaskStatus(req.status);
+    if (!status) {
+      return {
+        success: false,
+        error: `Invalid status: ${String(req.status)}`,
+      };
+    }
+
+    const body = req.clearBody
+      ? ""
+      : typeof req.body === "string"
+        ? req.body.trim()
+        : current.body;
+
+    const written = await writeTask({
+      projectRoot: root,
+      taskId,
+      overwrite: true,
+      frontmatter: {
+        title: nextTitle,
+        description,
+        when: whenNormalized.value,
+        sessionId,
+        kind,
+        ...(kind === "agent" && review ? { review: true } : {}),
+        status,
+      },
+      body,
+    });
+
+    return {
+      success: true,
+      title: nextTitle,
+      taskMdPath: written.taskMdPath,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: String(error),
+    };
+  }
+}
+
+export async function runTaskDefinition(params: {
+  context: AgentContext;
+  projectRoot: string;
+  request: TaskRunRequest;
+}): Promise<TaskRunResponse> {
+  const root = path.resolve(params.projectRoot);
+  const title = String(params.request.title || "").trim();
+  let taskId = "";
+  try {
+    taskId = await resolveTaskIdByTitle({ projectRoot: root, title });
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+  const reason = typeof params.request.reason === "string" ? params.request.reason.trim() : "";
+  const trigger = {
+    type: "manual" as const,
+    ...(reason ? { reason } : {}),
+  };
+
+  try {
+    // 关键点（中文）：run 改为“异步受理”，先做存在性校验，再后台执行。
+    await readTask({
+      taskId,
+      projectRoot: root,
+    });
+
+    params.context.logger.info(
+      formatTaskLogMessage("Manual task run accepted"),
+      {
+        taskId,
+        via: "manual",
+        ...(reason ? { reason } : {}),
+      },
+    );
+
+    const executionId = `${taskId}:${Date.now()}`;
+    void runTaskNow({
+      context: params.context,
+      projectRoot: root,
+      taskId,
+      trigger,
+      executionId,
+    })
+      .then((result) => {
+        params.context.logger.info(
+          formatTaskLogMessage("Manual task run finished"),
+          {
+            taskId,
+            via: "manual",
+            status: result.status,
+            executionStatus: result.executionStatus,
+            resultStatus: result.resultStatus,
+            ...(result.resultErrors.length > 0
+              ? { resultErrors: result.resultErrors }
+              : {}),
+            dialogueRounds: result.dialogueRounds,
+            userSimulatorSatisfied: result.userSimulatorSatisfied,
+            executionId: result.executionId,
+            timestamp: result.timestamp,
+            runDir: result.runDirRel,
+          },
+        );
+      })
+      .catch((error) => {
+        params.context.logger.error(
+          formatTaskLogMessage("Manual task run failed"),
+          {
+            taskId,
+            via: "manual",
+            error: String(error),
+          },
+        );
+      });
+
+    return {
+      success: true,
+      accepted: true,
+      // 关键点（中文）：这里直接返回给 agent 作为 tool result，提醒它这是异步任务，无需等待完成即可继续后续流程。
+      message: "任务已经开始执行，完成后 task 会自动发送给用户。请直接继续后续流程，无需等待 task 完成。",
+      executionId,
+      title,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: String(error),
+    };
+  }
+}
+
+export async function setTaskStatus(params: {
+  projectRoot: string;
+  request: TaskSetStatusRequest;
+}): Promise<TaskSetStatusResponse> {
+  const root = path.resolve(params.projectRoot);
+  const title = String(params.request.title || "").trim();
+  let taskId = "";
+  try {
+    taskId = await resolveTaskIdByTitle({ projectRoot: root, title });
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+  const status = normalizeTaskStatus(params.request.status);
+
+  if (!status) {
+    return {
+      success: false,
+      error: `Invalid status: ${String(params.request.status)}`,
+    };
+  }
+
+  try {
+    const task = await readTask({
+      projectRoot: root,
+      taskId,
+    });
+
+    await writeTask({
+      projectRoot: root,
+      taskId,
+      overwrite: true,
+      frontmatter: {
+        ...task.frontmatter,
+        status,
+      },
+      body: task.body,
+    });
+
+    return {
+      success: true,
+      title: task.frontmatter.title,
+      status,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: String(error),
+    };
+  }
+}
+
+export async function deleteTaskDefinition(params: {
+  projectRoot: string;
+  request: TaskDeleteRequest;
+}): Promise<TaskDeleteResponse> {
+  const root = path.resolve(params.projectRoot);
+  const title = String(params.request.title || "").trim();
+  let taskId = "";
+  try {
+    taskId = await resolveTaskIdByTitle({ projectRoot: root, title });
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+
+  try {
+    const deleted = await deleteTask({
+      projectRoot: root,
+      taskId,
+    });
+    return {
+      success: true,
+      title,
+      taskDirPath: deleted.taskDirPath,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: String(error),
+    };
+  }
+}

package/src/task/Index.ts

@@ -0,0 +1,8 @@
+/**
+ * Task plugin 静态导出入口。
+ *
+ * 关键点（中文）
+ * - Index 只保留导出职责，不再承载 task plugin 的具体实现。
+ * - 真正的类实现收敛到 `TaskPlugin.ts`。
+ */
+export { TaskPlugin } from "./TaskPlugin.js";

package/src/task/PROMPT.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/task/PROMPT.ts.txt
+const TEXT_MODULE_CONTENT = "# Task Plugin\n\n你可以通过 `task` plugin 管理任务定义、执行、调度与状态控制。\n\n## 任务模型\n\n每个任务定义在 `./.downcity/task/<title>/task.md`，包含：\n- frontmatter（结构化字段）\n- body（任务正文）\n\nfrontmatter 核心字段：\n- `title`：任务唯一标识（唯一）\n- `description`：任务描述\n- `when`：触发条件，支持：`@manual` / cron / `time:<ISO8601-with-timezone>`\n- `sessionId`：任务执行会话\n- `status`：`enabled|paused|disabled`\n- `kind`：`agent|script`（默认 `agent`）\n\n执行时会产生 run 目录：\n- `./.downcity/task/<title>/<timestamp>/`\n\n常见产物：\n- `input.md`\n- `output.md`（本次任务的最终输出正文）\n- `result.md`（执行摘要）\n- `run.json`\n- `run-progress.json`\n- `dialogue.md` / `dialogue.json`（agent 多轮）\n- `error.md`（失败时）\n\n## 执行类型（kind）\n\n1. `kind=agent`\n- 将正文交给 agent 执行\n- 默认单轮完成；仅当 frontmatter 显式设置 `review: true` 时启用模拟用户多轮复核\n- 适合研究、分析、报告生成\n\n2. `kind=script`\n- 将正文当作 shell 脚本执行\n- 正文不能为空，必须是可执行脚本\n\n## 可用 action\n\n- `list`\n- `create`\n- `run`\n- `delete`\n- `update`\n- `status`\n- `enable`\n- `disable`\n\n## CLI 示例\n\n- `city task list [--status enabled|paused|disabled]`\n- `city task create --title '...' --description '...' --session-id <sessionId> [--when '@manual'] [--kind agent|script] [--status ...|--activate]`\n- `city task run <title> [--reason '...']`\n- `city task update <title> [--title ...] [--description ...] [--when ...] [--status ...|--activate] [--session-id ...]`\n- `city task delete <title>`\n\n## 关键约束\n\n- `title` 唯一；create 去重仅按 `title` 精确匹配。\n- `when=time:...` 触发后会自动置为 `paused`，并回退为 `when=@manual`。\n- `run` 为异步受理：立即返回 `accepted=true`、`message`、`executionId`；调用方应把它视为“任务已进入后台执行，结果会自动通过 chat plugin runtime 发送，当前流程无需阻塞等待”。\n- 如果 `run` 返回 `accepted=true`：\n  - 不要手动把 task 产出再转发给用户。\n  - 不要主动读取 run 目录、`run-progress.json`、`output.md` 做轮询。\n  - 只有当用户明确要求排查、查看产物或确认执行细节时，才进入 run 目录检查。\n- agent 任务默认只要求产生有效输出；仅当任务正文明确要求外发时，才应发送到外部 channel。\n\n## 如何设计 task 正文\n\n### agent task 推荐结构\n\n建议正文至少包含这些标题：\n\n```md\n# 任务目标\n\n- 这次任务要交付什么最终结果\n\n# 背景与输入\n\n- 数据来源、范围、约束、参考材料\n\n# 执行步骤\n\n1. 先做什么\n2. 再做什么\n3. 关键中间产物落在哪里\n\n# 输出要求\n\n- 最终结果用什么格式返回\n- 是否需要表格 / JSON / Markdown\n- 不要包含什么内容\n\n# 触发与状态建议\n\n- 这个任务为什么适合 `@manual` / cron / `time:...`\n- 当前应该是 `paused` 还是 `enabled`\n\n# 注意事项\n\n- 风险、边界、不要做什么\n```\n\n### agent task 正文编写约束\n\n- task 正文必须像一份“交付合同”，让另一个执行器拿到后可以直接执行，不依赖当前聊天语境补全含义。\n- `# 任务目标` 必须写清楚最终要交付什么，不要只写“看一下”“研究一下”“处理一下”这类模糊目标。\n- `# 背景与输入` 必须写清来源、范围、对象、时间、限制条件；不要假设执行器还能看到原始聊天上下文。\n- `# 执行步骤` 应描述任务流程，不应描述 task 管理动作；不要写“先检查有没有同名任务”“再创建任务”“然后触发任务”。\n- `# 输出要求` 必须清楚声明最终成品的格式、结构、语气、长度，以及“不要输出什么”。\n- 要明确写出：**最后一条 assistant 返回会被直接写入 `output.md` 并发送给用户**；因此最终回答必须直接等于成品内容。\n- 内容生成类任务（如日报、提醒、晨读、摘要、报告）必须明确要求“最终输出直接是成品正文”，不要让执行器输出过程说明。\n- 如果任务要把结果发给用户，正文应要求“输出可直接发送的正文内容”，而不是要求执行器解释自己已经发送了什么。\n- 除非确有需要，不要在正文中要求执行器复述 task title、sessionId、执行时间、状态等元信息。\n- 正文中的约束要可执行、可判断，尽量避免“适当”“尽量”“看情况”这类弱约束词。\n- 不要把创建 task、更新 task、查看 task 状态、确认 task 是否存在等管理动作写进正文；这些属于 task plugin 的职责，不属于 task 正文交付物。\n\n### agent task 正文禁止写法\n\n- 不要把正文写成聊天回复口吻，例如：\n  - “我来为你……”\n  - “首先让我……”\n  - “我先检查一下……”\n  - “我看到已经有一个同名任务……”\n- 不要把正文写成任务管理说明，例如：\n  - “如果任务已存在则更新，否则创建”\n  - “先 list 再 run”\n  - “完成后告诉用户任务已启动”\n- 不要把正文写成状态汇报模板，例如：\n  - “任务状态总结”\n  - “已发送 / 已完成 / 已更新”\n  - “当前任务配置如下”\n- 不要只描述动作，不描述成品，例如：\n  - “去搜集一些资料”\n  - “生成一个内容看看”\n  - “做完后反馈结果”\n- 不要把正文写成依赖当前上下文的指代，例如：\n  - “按上面说的做”\n  - “继续刚才那个”\n  - “把这个发出去”\n\n### 如何判断正文写得对不对\n\n- 如果把 task 正文单独复制出来给另一个 agent，它仍然能理解任务目标、输入、步骤和交付物，说明正文合格。\n- 如果最终输出章节删掉后，正文只剩“去做一下”式描述，说明正文不合格。\n- 如果正文更像“创建/更新任务的操作说明”，而不是“任务执行说明”，说明分层错了，必须重写。\n- 如果正文天然会诱导执行器输出过程汇报，而不是最终成品，说明 `# 输出要求` 写得不够强，必须补充禁止项。\n\n### script task 推荐结构\n\n- 正文必须是纯 shell 脚本，不要混入解释性自然语言。\n- 开头尽量写注释说明脚本目的、输入依赖、失败条件。\n- 输出保持稳定，便于直接作为最终结果发送给用户。\n- 如需生成文件，写到 run 目录或明确的项目路径。\n\n### 输出设计原则\n\n- task 完成后，系统会自动把**最终结果正文**通过 chat plugin runtime 的 `send` 发回 `sessionId` 绑定的 chat。\n- 当前实现采用最简规则：**最后一条 assistant 返回**会被直接视为最终结果正文，并写入 `output.md`。\n- 因此正文里的“输出要求”要面向最终用户阅读，不要只写给开发者看。\n- 对于面向用户的 agent task，正文应要求“最后一条 assistant 返回直接输出最终交付物本身”，不要让执行器在最后回答里输出自己如何创建、检查、更新、触发或发送任务。\n- 如果任务是内容生成类（例如日报、提醒、晨读、摘要），最后输出应直接是那段内容本身，不要附带“我来为你处理”“任务已发送”“任务状态总结”等过程汇报。\n- 默认不要在正文里再次要求执行器调用 `city chat send`。\n- 只有在“跨会话发送”“额外抄送”“多渠道通知”这类场景下，才显式要求 `city chat send`。\n\n### `when` / `status` 怎么选\n\n- task 创建默认就是 `status=enabled`；如果还在试任务、容易失败、需要人工确认，再显式切到 `paused`。\n- 已经验证稳定、需要自动运行：直接使用 cron + `status=enabled`。\n- 明确只执行一次：使用 `time:<带时区 ISO 时间>`；执行后系统会自动回退到 `@manual` + `paused`。\n- 如果用户只是“先存起来以后再跑”，不要直接启用调度。\n\n## 正文模板\n\n### agent 模板\n\n```md\n# 任务目标\n\n- 产出一份可直接发给用户的最终结果。\n\n# 背景与输入\n\n- 在这里补充上下文、文件、链接、范围和假设。\n\n# 执行步骤\n\n1. 理解任务目标与完成标准。\n2. 收集必要信息并执行任务。\n3. 把关键中间产物写入 run 目录。\n4. 输出最终结果正文。\n\n# 输出要求\n\n- 最后一条 assistant 返回直接作为最终结果，不要附带冗长日志。\n- 最后一条 assistant 返回直接输出交付物本身，不要输出任务管理过程、发送过程或状态汇报。\n- 不要使用“我来为你…… / 首先让我…… / 已发送……”这类元话术。\n- 默认不要再次调用 `city chat send`。\n\n# 触发与状态建议\n\n- 默认创建后立即启用；如果只是先保存草稿或等待人工确认，再改成 `paused`。\n\n# 注意事项\n\n- 仅在明确需要跨会话或额外通知时，才调用 `city chat send`。\n```\n\n### script 模板\n\n```bash\n# 任务目标：一句话说明脚本要做什么\n# 输入依赖：列出环境变量、文件、命令依赖\n# 失败条件：列出应该 exit 1 的情况\n\nset -euo pipefail\n\n# 1. 准备输入\n\n# 2. 执行主逻辑\n\n# 3. 输出最终结果（这段输出会被直接发送给用户）\n```\n\n## 建议\n\n- 先 `list`，再 `create`/`update`。\n- 简单内容生成任务优先保持默认单轮；只有确实需要“先生成、再复核、再修订”时再设置 `review: true`。\n- script 任务正文保持纯脚本，不要混入冗余自然语言。\n- 如果用户只是先存起来以后再跑，创建后显式设成 `paused`；否则保持默认启用。\n- task 正文要写“最终结果长什么样”，不要只写“去做一下看看”。\n- 对内容生成任务，要明确写“最后一条 assistant 返回只能是成品正文”，避免执行器把过程说明误当成最终结果。\n";
+
+export default TEXT_MODULE_CONTENT;