# 模板

## 1. 结构化归档判断输出模板

当使用本 skill 做归档判断时，默认输出应尽量接近以下结构：

```yaml
archive_decision: <archive|do_not_archive>
reason: <为什么归档或为什么不归档>
project_detected: <yes|no>
project_id: <若识别到则填写，否则为 none>
target_files:
  - <目标文件路径 1>
  - <目标文件路径 2>
write_mode: <append|create|no_write>
content_summary: <提炼后的归档摘要>
promotion_level: <project|lesson|engineering-standard|none>
```

若信息不足, 必须明确输出:
信息不足，暂不归档；请补充 project-id 或项目名称。

## 2. context.md 追加模板

适用于补充项目背景、目标、范围、非目标、约束。

## 上下文补充（<YYYY-MM-DD>）

### 背景
- <背景信息>

### 目标
- <目标 1>
- <目标 2>

### 范围
- <范围内容>

### 非目标
- <本轮明确不做的内容>

### 约束
- <约束条件>

## 3. roadmap.md 追加模板

适用于记录阶段规划、里程碑、下一步计划。

## 路线图更新（<YYYY-MM-DD>）

### 当前阶段
- <M0/M1/M2/M3/M4/M5/M6>

### 已完成
- <已完成事项 1>
- <已完成事项 2>

### 下一步
- <下一步 1>
- <下一步 2>

### 后续阶段建议
- <阶段建议>

## 4. reports.md 追加模板

适用于记录阶段结果、状态、交付、验收摘要。

## 阶段汇报（<YYYY-MM-DD>）

### 当前阶段
- <阶段名称>

### 当前状态
- <DONE/BLOCKED/PAUSED/FAILED/待确认>

### 本轮完成
- <完成项 1>
- <完成项 2>

### 关键产物
- <文件/能力/结果>

### 当前结论
- <一句话结论>

### 下一步建议
- <下一步建议>

## 5. decisions.md 追加模板

适用于记录关键确认、技术选择、边界取舍。

## 决策记录（<YYYY-MM-DD>）

### 决策主题
- <决策标题>

### 决策内容
- <明确结论>

### 产生原因
- <为什么做这个决定>

### 影响范围
- <影响到哪些阶段/模块/流程>

### 备注
- <补充说明，可选>

## 6. risks.md 追加模板

适用于记录阻塞、依赖、隐患与后续风险。

## 风险记录（<YYYY-MM-DD>）

### 风险标题
- <风险名称>

### 风险说明
- <风险是什么>

### 当前影响
- <会影响什么>

### 建议处理方式
- <建议怎么处理>

### 当前状态
- <待处理/处理中/已缓解/已关闭>

## 7. lesson 模板

目标路径示例：

/root/ai-company/memory/ai-org-memory/lessons/team-alpha/<project>-lessons.md

适用于沉淀项目经验与团队复用知识。

## Lesson（<YYYY-MM-DD>）

### 项目
- <project-id>

### 标题
- <一句话经验标题>

### 触发情境
- <这条 lesson 是在什么情况下暴露出来的>

### 经验结论
- <学到了什么>

### 下次规则
- <以后应该怎么做>

### 备注
- <可选补充>

## 8. engineering-standards 变更模板

适用于将稳定、跨项目的工程规则提升到组织级规范。

目标文件：

/root/ai-company/memory/ai-org-memory/company/engineering-standards.md

## 变更记录（<YYYY-MM-DD>）

### 来源项目
- <project-id>

### 变更主题
- <规则标题>

### 变更原因
- <为什么需要升级成 engineering standard>

### 规则内容
- <规范本体>

### 预期收益
- <这条规则将防止什么问题>

## 9. 会议纪要提炼模板

适用于从飞书会议纪要、聊天纪要中提炼可归档内容，而不是原样写入。

### 纪要提炼结果

- 项目归属：<project-id 或 none>
- 关键结论：
  - <结论 1>
  - <结论 2>
- 决策项：
  - <决策 1>
- 风险项：
  - <风险 1>
- 后续动作：
  - <动作 1>
- 归档建议：
  - <建议写入哪个文件>

  ### 纪要提炼结果

- 项目归属：<project-id 或 none>
- 关键结论：
  - <结论 1>
  - <结论 2>
- 决策项：
  - <决策 1>
- 风险项：
  - <风险 1>
- 后续动作：
  - <动作 1>
- 归档建议：
  - <建议写入哪个文件>

## 10. 日常飞书聊天提炼模板

适用于将临时聊天整理为长期有效信息。

### 聊天提炼结果

- 是否值得归档：<是/否>
- 原因：<为什么>
- 项目归属：<project-id 或 none>
- 提炼摘要：
  - <摘要 1>
  - <摘要 2>
- 推荐写入：
  - <目标文件>

## 11. 使用模板时的注意事项

- 模板是约束结构，不是强制逐字照抄

- 能简洁表达就不要写冗余文字

- 原始聊天不能直接原样进入长期记忆

- 归档时优先保留结论、边界、风险、里程碑、经验

- 不要把暂时猜测写成正式事实