메뉴
将数字员工的产出文件（产品规格文档、验收报告、设计文档等）写入共享工作区或个人工作区。 用于 PM 写 product_spec.md、Manager 写 review_result.md 等场景。 与 memory-save 的区别：本 Skill 专门用于写工作产出，memory-save 用于写记忆/会话状态。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
技术设计文档 SOP——从需求到设计方案，产出 Markdown 文件到 /workspace/output/
Agent 自我复盘：读取 L2/L3/L1 日志，调用 LLM 生成结构化改进提案， 写入 proposals.json 并发通知至 human.json 等待审批。 适用场景：Agent 在完成足够多任务后，触发自我评估和改进提案生成。
Manager 团队复盘：聚合所有 Agent 的 L2 质量指标，统计 L1 人类纠正事件， 识别瓶颈 Agent 并触发其自我复盘，调用 LLM 生成团队级改进提案， 向 human.json 发送周报。
审批复盘提案（Manager 专用）。收到 type=retro_report 邮件时加载此 Skill。按改动深度分档，memory 自动批准（加闸门），skill/agent 转 Human 确认，soul 标记高风险转 Human。
团队复盘思考框架（Manager 专用）。当你收到 type=team_retro_trigger 的邮件、或被要求"做团队复盘"时加载此 Skill。从聚合视角分析全员数据，发现跨 Agent 问题，级联触发瓶颈 Agent 的自我复盘，发周报给 Human。
自我复盘思考框架。当你收到 type=retro_trigger 的邮件、或被要求"反思本周工作"/"自我复盘"时加载此 Skill。用 log_query CLI 查数据，用 LLM 推理做分析，产出结构化复盘报告和改进提案。
| name | write-output |
| description | 将数字员工的产出文件（产品规格文档、验收报告、设计文档等）写入共享工作区或个人工作区。 用于 PM 写 product_spec.md、Manager 写 review_result.md 等场景。 与 memory-save 的区别：本 Skill 专门用于写工作产出，memory-save 用于写记忆/会话状态。 |
| allowed-tools | ["sandbox_file_operations","sandbox_execute_bash"] |
将数字员工完成的产出物（文档、报告等）持久化写入沙盒指定路径。
绝对禁止通过 sandbox_execute_bash 的 --content 参数传递文件内容：
# ❌ 已删除的旧方式（不要使用）
old_bash_approach(
cmd='python3 write_file.py --path "..." --content "大段内容..."' # shell 会截断内容！
)
原因：内容经过 JSON→shell 双重序列化，shell 遇到特殊字符会静默截断，
导致写入的文件内容不完整，但 errcode 仍可能返回 0（字节数是截断后的大小）。
必须使用 sandbox_file_operations 的 write action，内容通过 MCP 协议
以 JSON 字段直接传递，完全绕过 shell 解析，不存在特殊字符转义问题。
| 角色 | 产出路径 |
|---|---|
| PM（产品规格） | /mnt/shared/design/product_spec.md |
| Manager（验收报告） | /workspace/review_result.md |
| Manager（需求文档） | /mnt/shared/needs/requirements.md |
| Dev（技术设计） | /workspace/tech_design.md |
sandbox_file_operations(action="write", ...) 实际写入文件expected_output 字段猜测结果调用 sandbox_file_operations 工具，参数如下：
action："write"path：目标文件绝对路径content：完整文件内容（直接传入多行字符串，无需任何转义）示例：
sandbox_file_operations(
action="write",
path="/workspace/tech_design.md",
content="# 技术设计记录\n\n## T-01 ...\n\n### 接口定义\n..."
)
写入后立即用 sandbox_file_operations 读取，验证文件大小与内容：
sandbox_file_operations(
action="read",
path="/workspace/tech_design.md"
)
sandbox_file_operations(
action="write",
path="/mnt/shared/design/product_spec.md",
content="# 产品规格文档
## 产品概述
一句话描述产品
## 目标用户
...
## 用户故事
...
## 功能规格
F-01（P0）: 用户注册
..."
)
sandbox_file_operations(
action="write",
path="/workspace/review_result.md",
content="# 验收报告
**验收结论**：✅ 通过
..."
)
sandbox_file_operations(
action="write",
path="/workspace/tech_design.md",
content="# 技术设计记录
**日期**: 2026-03-26
**类型**: tech_design
## T-01 自然语言日程解析模块技术设计
..."
)
如果 sandbox_file_operations 的 write action 报错，可用以下方式通过 Python 代码写入：
⚠️ 注意：content 内容中如包含三引号
"""字符，需将其替换为\"\"\"，避免 Python 字符串提前终止。
sandbox_execute_code(
language="python",
code="""
content = \"\"\"（此处粘贴完整内容）\"\"\"
from pathlib import Path
p = Path("/workspace/tech_design.md")
p.parent.mkdir(parents=True, exist_ok=True)
p.write_text(content, encoding="utf-8")
print(f"写入成功：{p.stat().st_size} 字节")
"""
)
注意：不得使用 sandbox_execute_bash --content 方式，即便是备用方案也禁止。