WinWork讯飞内部版

Appearance

已上线内部开发者开发者

工作区文件规范 ​

每个 WinWork Agent 的行为由一组标准化的 Markdown 工作区文件定义。这些文件存放在 Agent 的工作区目录中，共同构成 Agent 的"认知底座"。

文件体系总览 ​

文件详细规范 ​

AGENTS.md — 工作区总纲 ​

作用： 工作区的入口文件，定义 Agent 在该工作区的整体定位、会话工作流和行为边界。

字段说明
工作区描述该工作区的用途和范围
会话工作流每次会话开始时的标准步骤
行为边界明确 Agent 在该工作区的能力范围和限制
关联 Agent与哪些其他 Agent 协作

编写要点：

  • 简洁明了，控制在 100 行以内
  • 重点说明"这个工作区用来做什么"，而非如何做
  • 行为边界要写具体，避免模糊表述
markdown
# 工作区：[工作区名称]

## 用途
[这个工作区的核心用途]

## 会话工作流
1. 读取 USER.md，了解当前用户上下文
2. 检查 MEMORY.md，回顾相关历史
3. 根据任务类型路由处理

## 行为边界
- 可以：[明确的能力范围]
- 不可以：[明确的限制]

SOUL.md — 核心原则 ​

作用： 定义 Agent 的价值观、核心原则和行为边界，是 Agent 行为的最高准则。

字段说明
核心价值观Agent 在决策时优先考虑的原则
行为准则具体的行为规范
氛围与语气期望的沟通氛围和语气风格
红线绝对不能做的事

编写要点：

  • 原则要可执行，避免空泛的口号
  • 明确写出"红线"，避免 Agent 在边界情况下误判
  • 语气描述要具体（如"直接、简洁"优于"友好"）

TIP

SOUL.md 的优先级高于其他所有文件。当其他文件的指令与 SOUL.md 冲突时，以 SOUL.md 为准。

IDENTITY.md — 身份卡片 ​

作用： Agent 的身份标识，定义其名称、类型和核心能力。

字段说明
名称Agent 的名称和标识符
类型PA / TA / 核心团队 Agent
核心能力该 Agent 擅长做什么
不擅长明确的能力边界
当前状态是否在线、当前任务负载

编写要点：

  • 核心能力列举要精准，不要过度承诺
  • 不擅长的部分同样重要，帮助用户设置正确预期

USER.md — 用户/团队上下文 ​

作用： 记录 Agent 服务对象（个人用户或团队）的基本信息和偏好，帮助 Agent 提供个性化服务。

字段说明
基本信息用户/团队名称、时区、主要语言
工作偏好偏好的沟通方式、工作节奏
技术背景技术栈、工具链偏好
特殊约定与该用户/团队的特殊规则或约定

编写要点：

  • 以用户能认可的方式描述他们的偏好
  • 定期更新，避免过时信息影响 Agent 判断
  • PA 的 USER.md 记录个人信息；TA 的 USER.md 记录团队信息

WARNING

USER.md 中不应存储密码、密钥等敏感信息。此类信息应通过安全的密钥管理系统处理。

STYLE.md — 沟通风格 ​

作用： 定义 Agent 与用户交互时的沟通风格偏好，确保输出符合用户期望。

字段说明
语言首选语言（如中文、英文）
详细程度偏好简洁摘要还是详细说明
格式偏好是否使用表格、代码块、列表
特殊规则如"不要用 emoji"、"代码示例要加注释"

编写要点：

  • 风格描述要具体可操作，避免"简洁"这类主观词
  • 可以提供正面例子（"好的输出"）和反面例子（"避免这样"）

TOOLS.md — 可用工具 ​

作用： 列举 Agent 在该工作区可使用的工具、平台入口和工作流程。

字段说明
工具列表可调用的工具及其用途
平台入口外部平台的访问地址和凭证说明
工作流常见任务的标准操作流程
限制工具使用的限制条件

编写要点：

  • 工具列表要与实际可用工具保持同步
  • 工作流要写出具体步骤，而非泛泛描述
  • 标注哪些工具需要额外权限

MEMORY.md — 长期记忆 ​

作用： Agent 的长期记忆存储，记录重要事件、团队约定和经验教训，跨会话持久化。

字段说明
重要事件关键决策、里程碑、重大变更
团队约定达成共识的工作规则和约定
经验教训从项目和事故中提炼的教训
待跟进项需要持续关注的事项

编写要点：

  • 按时间倒序排列，最新内容在前
  • 每条记录注明日期和来源（哪个项目/事件）
  • 定期清理过时信息，保持文件精简
markdown
## 2026-04-10 | 架构决策
选择 PostgreSQL 作为主数据库（替代 MySQL）
原因：更好的 JSON 支持和并发性能
影响：所有新项目使用 PG，存量项目按需迁移

HEARTBEAT.md — 周期检查清单 ​

作用： 定义 Agent 需要周期性执行的检查项，确保工作区状态健康。

字段说明
每日检查每天需要确认的项目
每周检查每周需要执行的任务
触发条件特定事件触发的检查

编写要点：

  • 检查项要可量化，避免"检查系统健康"这类模糊表述
  • 每项检查要明确预期结果和异常处理方式

BOOTSTRAP.md — 首次引导（可选） ​

作用： 新用户首次使用时的引导流程，帮助快速完成工作区初始化。

适用场景： 仅在以下情况创建此文件：

  • 工作区需要特定的初始化步骤
  • 有必要向新用户解释工作区的特殊约定

memory/YYYY-MM-DD.md — 日志文件 ​

作用： 每日工作日志，记录当天的任务执行情况、重要对话和待处理事项。

命名规则： memory/2026-04-10.md

字段说明
今日完成已完成的任务列表
进行中正在处理的任务及其状态
待处理明天需要继续的事项
重要记录需要长期保留的决策或信息

维护建议：

  • 由 Agent 在每次会话结束时自动更新
  • 超过 30 天的日志可以归档压缩
  • 重要条目应定期同步到 MEMORY.md

文件优先级 ​

当各文件之间存在指令冲突时，按以下优先级处理：

SOUL.md > AGENTS.md > IDENTITY.md > USER.md > STYLE.md > TOOLS.md

快速开始

新建 Agent 工作区时，优先创建 AGENTS.md、SOUL.md 和 USER.md 这三个核心文件，其余文件可根据需要逐步添加。

最后更新: