# skill-jasmine · Jasmine 的个人技能仓库

Claude Code / 兼容 Agent 的技能沉淀仓库：把与 Agent 对话中验证过的可复用方法、SOP、脚本归档于此，供多项目、多任务直接复用。

## 技能索引

| 技能 | 状态 | 版本 | 解决的问题 |
|---|---|---|---|
| [商机周复盘](./商机周复盘/SKILL.md) | 正式 | v1.0.0 | 商机健康度周复盘自动化：三时钟分区 + 五维赢面分 + 跟进建议三件套，人工 2 小时 → 5 分钟 |

## 目录规范

```
skill-jasmine/
├── README.md            # 本文件：用途、技能索引、规范说明
├── <技能名>/             # 每个技能一个目录（通用方法与专属配置分离）
│   ├── SKILL.md         # 技能定义：Agent 可直接执行的完整规则
│   ├── scripts/         # 可重跑脚本（工具化、程序化的部分）
│   ├── examples/        # 示例请求与示例结果
│   ├── tests/           # 最小可执行测试
│   ├── changelog.md     # 版本变更记录
│   └── outputs/         # 每次任务的产出物归档（按 项目/日期-任务 分层）
│       └── <项目>/<YYYY-MM-DD>-<任务名>/
```

## 产出物归档规则

- 每次执行技能产生的仪表盘、报告、数据结果，统一放该技能 `outputs/<项目>/<日期>-<任务>/` 下
- **对外可见的产出物必须先脱敏**（公司名/人名编号化，见 `商机周复盘/scripts/anonymize.py`），映射表只留本地
- 大二进制不入 Git；公开分享用仓库 raw 链接或对象存储上传后的公开 URL

## 成果上报方式

本仓库配套两个平台技能（已安装于 `~/.claude/skills/`）：

1. **fmode-task-progress** — 任务四态上报（ack→running→done/failed + 心跳）与成果 deliver 入库；每个任务开始即 ack、开工 running、验收过才 done，交付物产出即报
2. **fmode-storage** — 产出物 HTML 上传对象存储换公开 URL（平台 STS 接口未部署前，公开链接以本仓库 raw URL 代替）

## 维护约定

- 技能升级记版本号、变更原因、测试结果，写入对应技能 changelog.md
- 只提交相关技能文件与测试，Conventional Commit 信息，不提交密钥/映射表/真实客户数据
- 推送失败保留本地提交并报告真实原因