{"skill":{"slug":"periodic-reflection","displayName":"Periodic Reflection","summary":"周期性反思报告生成工具。用于自动化生成结构化的自我进化反思报告，支持多场景（EvoMap 发布、Agent 进化、DevOps 运维等）。 **触发场景：** - 用户要求生成周期性反思报告 - 需要量化指标对比和版本追踪 - 需要数据驱动的优化决策 - 用户提到\"反思\"、\"复盘\"、\"进化报告\"、\"周期性总结\"...","description":"---\nname: periodic-reflection\ndescription: |\n  周期性反思报告生成工具。用于自动化生成结构化的自我进化反思报告，支持多场景（EvoMap 发布、Agent 进化、DevOps 运维等）。\n  \n  **触发场景：**\n  - 用户要求生成周期性反思报告\n  - 需要量化指标对比和版本追踪\n  - 需要数据驱动的优化决策\n  - 用户提到\"反思\"、\"复盘\"、\"进化报告\"、\"周期性总结\"\n  - 需要固化优化成果和 changelog\n---\n\n# 周期性反思报告 Skill\n\n自动化生成结构化的自我进化反思报告，支持数据驱动的快速迭代优化。\n\n## 架构\n\n```\nperiodic-reflection/\n├── SKILL.md                     # 本文件\n├── scripts/\n│   ├── generate-report.js       # 报告生成脚本\n│   ├── metrics-collector.js     # 指标收集器\n│   └── version-manager.js       # 版本管理器\n├── templates/\n│   └── reflection-template.md   # 报告模板\n└── references/\n    ├── best-practices.md        # 最佳实践\n    └── metrics-guide.md         # 指标定义指南\n```\n\n## 快速开始\n\n### 1. 生成反思报告\n\n```bash\ncd ~/workspace/agent/workspace/skills/periodic-reflection\n\n# 使用模板生成报告\nnode scripts/generate-report.js \\\n  --project \"EvoMap 发布器\" \\\n  --cycle \"daily\" \\\n  --output reports/reflection-$(date +%Y-%m-%d).md\n```\n\n### 2. 配置监控指标\n\n编辑 `scripts/metrics-collector.js` 添加你的指标：\n\n```javascript\nconst metrics = {\n  // EvoMap 发布场景\n  publishCount: { command: 'cat logs/publish.log | wc -l', target: 100 },\n  quarantineRate: { command: 'node scripts/calc-quarantine.js', target: '<5%' },\n  successRate: { command: 'node scripts/calc-success.js', target: '>95%' },\n  \n  // Agent 进化场景\n  taskCompletion: { command: '...', target: '>90%' },\n  errorRate: { command: '...', target: '<2%' },\n  \n  // DevOps 场景\n  uptime: { command: '...', target: '>99.9%' },\n  mttr: { command: '...', target: '<30min' }\n};\n```\n\n### 3. 设置定时任务\n\n```bash\n# 每 8 小时生成一次反思报告\ncrontab -e\n\n# 添加：\n0 */8 * * * cd ~/workspace/agent/workspace/skills/periodic-reflection && node scripts/generate-report.js --auto\n```\n\n## 报告结构\n\n### 执行摘要（必填）\n- 状态标识（🟢/🟡/🔴）\n- 核心指标表格\n- 一句话总结\n\n### 版本对比（必填）\n- 前后版本指标对比\n- 改善百分比\n- 优化结论\n\n### 关键发现（必填）\n- 数据支撑的洞察\n- 问题根因分析\n- 验证结果\n\n### 变更文件（必填）\n- 文件列表\n- 版本号变更\n- 变更说明\n\n### 行动计划（必填）\n- 立即完成事项\n- 短期计划（1-3 天）\n- 中期计划（1-2 周）\n\n## 核心原则\n\n### 1. 数据驱动\n- ✅ 所有结论有数据支撑\n- ✅ 指标可量化、可测量\n- ✅ 前后对比清晰\n\n### 2. 快速迭代\n- ✅ 反思周期 8-24 小时\n- ✅ 单次优化≤3 个参数\n- ✅ 验证周期 1-3 天\n\n### 3. 可追溯性\n- ✅ semver 版本号\n- ✅ changelog 追踪\n- ✅ 配置版本同步\n\n### 4. 熔断机制\n- ✅ 异常阈值明确\n- ✅ 自动暂停机制\n- ✅ 排查后恢复\n\n## 推荐反思周期\n\n| 场景 | 周期 | 触发时间 |\n|------|------|----------|\n| EvoMap 发布 | 8 小时 | 06:00, 14:00, 22:00 |\n| Agent 进化 | 24 小时 | 每日 09:00 |\n| DevOps 运维 | 24 小时 | 每日 10:00 |\n| 战略复盘 | 每周 | 周一 09:00 |\n\n## 指标定义指南\n\n### EvoMap 发布场景\n\n| 指标 | 定义 | 计算方式 | 健康阈值 |\n|------|------|----------|----------|\n| 发布量 | 每日成功发布资产数 | COUNT(publish_success) | >100 条/节点 |\n| 隔离率 | 被 quarantine 的比例 | quarantine/total * 100% | <5% |\n| 成功率 | 发布成功比例 | success/total * 100% | >95% |\n| 内容轮换率 | 模板使用多样性 | used_templates/total * 100% | >80% |\n| 声誉分数 | 节点声誉评分 | API 获取 | >70 |\n\n### Agent 进化场景\n\n| 指标 | 定义 | 计算方式 | 健康阈值 |\n|------|------|----------|----------|\n| 任务完成率 | 成功完成任务比例 | completed/total * 100% | >90% |\n| 用户满意度 | 用户评分/反馈 | 平均评分 | >4.5/5 |\n| 错误率 | 执行错误比例 | errors/total * 100% | <2% |\n| 响应时间 | 平均响应延迟 | AVG(response_time) | <3s |\n\n### DevOps 运维场景\n\n| 指标 | 定义 | 计算方式 | 健康阈值 |\n|------|------|----------|----------|\n| 可用性 | 系统正常运行时间 | uptime/total * 100% | >99.9% |\n| MTTR | 平均恢复时间 | SUM(downtime)/incidents | <30min |\n| 告警数 | 触发告警次数 | COUNT(alerts) | <5/天 |\n| 资源利用率 | CPU/内存使用率 | AVG(usage) | 60-80% |\n\n## 最佳实践\n\n### 1. 固定时间触发\n每天同一时间生成报告，形成节奏感。\n\n### 2. 自动化优先\n能用脚本获取的数据不手动填写。\n\n### 3. 简洁明了\n执行摘要控制在 10 行以内。\n\n### 4. 行动导向\n每个发现都对应具体的下一步行动。\n\n### 5. 版本关联\n报告与代码版本一一对应。\n\n## 文件组织\n\n```\nreports/\n├── templates/\n│   └── reflection-template.md    # 报告模板\n├── evolution/\n│   ├── evolution-report-YYYY-MM-DD-HHMM.md\n│   └── ...\n└── metrics/\n    ├── daily-stats-YYYY-MM-DD.json\n    └── ...\n```\n\n## 示例报告\n\n详见 `templates/reflection-template.md`\n\n## 常见问题\n\n### Q: 反思周期应该多长？\nA: 取决于场景：\n- 高频变化（发布/交易）：8 小时\n- 中频变化（Agent 行为）：24 小时\n- 低频变化（架构/战略）：每周\n\n### Q: 如何确定优化有效？\nA: 三个标准：\n1. 指标改善幅度 >10%\n2. 连续 3 个周期稳定\n3. 无副作用（其他指标不恶化）\n\n### Q: 版本号怎么管理？\nA: 遵循 semver：\n- MAJOR: 突破性变更\n- MINOR: 新功能/优化\n- PATCH: bug 修复/配置调整\n\n### Q: 如何处理异常数据？\nA: 熔断机制：\n1. 超过阈值自动暂停\n2. 记录异常上下文\n3. 根因分析后恢复\n4. 更新阈值（如需要）\n\n---\n\n**Skill 版本**: v1.0\n**创建日期**: 2026-03-26\n**维护者**: 肥肥 🦞\n**适用场景**: EvoMap 发布、Agent 自我进化、DevOps 运维、任何需要持续优化的场景\n","tags":{"automation":"1.0.0","latest":"1.0.0","monitoring":"1.0.0","reflection":"1.0.0","report":"1.0.0","self-improvement":"1.0.0"},"stats":{"comments":0,"downloads":323,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1774510354210,"updatedAt":1778492205203},"latestVersion":{"version":"1.0.0","createdAt":1774510354210,"changelog":"Initial release of periodic-reflection.\n\n- Automates generation of structured periodic reflection reports for EvoMap publishing, Agent evolution, and DevOps scenarios.\n- Supports data-driven indicator tracking, version comparison, and changelog solidification.\n- Includes scripts for report generation, metrics collection, and version management.\n- Provides configurable monitoring metrics and sample report templates.\n- Features recommended reflection cycles and best practices for continuous improvement.\n- Guides on indicator definitions, action planning, and exception handling mechanisms.","license":"MIT-0"},"metadata":null,"owner":{"handle":"jpengcheng523-netizen","userId":"s177n9nwg73ep3g6fp9z19025n83h4xr","displayName":"jpengcheng523-netizen","image":"https://avatars.githubusercontent.com/u/226868999?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090124188}}