doc-coauthoring
npx skills add https://github.com/zephyrwang6/myskill --skill doc-coauthoring
Agent 安装分布
Skill 文档
Doc Co-Authoring Workflow
åä½å¼ææ¡£åä½å·¥ä½æµãä¸ä¸ªé¶æ®µï¼Context Gathering â Refinement & Structure â Reader Testingã
When to Offer This Workflow
è§¦åæ¡ä»¶ï¼
- ç¨æ·æå°åæç« ãåææ¡£ãco-authoring
- ç¨æ·æä¾ç´ æå¹¶è¦æ±åä½å 容
ç®çè¯´ææµç¨åç´æ¥å¼å§ï¼ä¸è¦è¿åº¦è§£éã
Stage 1: Context Gathering
ç®æ ï¼ å¿«éè·åè¶³å¤ä¸ä¸æï¼å æ¬å 容æ¹åååä½é£æ ¼ã
å ä¿¡æ¯ï¼å¿ é®ï¼
- ææ¡£ç±»åï¼ï¼å ¬ä¼å·/å°çº¢ä¹¦/ææ¯ææ¡£/ææ¡ï¼
- ç®æ 读è ï¼
- 读å®åç颿ææï¼
- ä½ ç个人è§ç¹/è§åº¦ï¼
- ç¯å¹ å飿 ¼ï¼
åä½é£æ ¼å好ï¼å¿ é®ï¼
å ³é®ï¼æåç¡®è®¤é£æ ¼ï¼é¿å åç»åå¤ä¿®æ¹ã
询é®ç¨æ·ï¼
- æåèèµæåï¼ï¼å¦æï¼å åæå ¶é£æ ¼å¹¶éµå¾ªï¼
- åç®æ´è¿æ¯è¯¦ç»ï¼
- æä»ä¹åä½ä¹ æ¯éè¦éµå®ï¼
åèèµæé£æ ¼åæ
å¦æç¨æ·æä¾äºåèèµæï¼
å 读åå¹¶åæå ¶åä½é£æ ¼ï¼
- å¥å¼ç¹ç¹ï¼çå¥ä¸ºä¸»ï¼é¿å¥ä¸ºä¸»ï¼ï¼
- ç»ææ¹å¼ï¼ææ å°æ é¢ï¼æ®µè½é¿åº¦ï¼ï¼
- è¯æ°ï¼å£è¯åï¼æ£å¼ï¼ï¼
- é¿å çæ¨¡å¼
åæå®æååç¥ç¨æ·ï¼”åèèµæé£æ ¼å·²å¦ä¹ ï¼åç»åä½ä¼éµå¾ªã”
常è§åä½å模å¼ï¼é»è®¤é¿å ï¼
é¤éç¨æ·æç¡®è¦æ±ï¼å¦åé¿å ï¼
- èªé®èªçå¥å¼ï¼â “è¿æå³çä»ä¹ï¼å®æå³ç…” â â ç´æ¥éè¿°
- è¿åº¦å¯¹æ¯ï¼â “䏿¯…èæ¯…” è¿ç¨å¤æ¬¡ â â ç´æ¥è¯´æ¯ä»ä¹
- å°æ é¢å岿¡ä¾ï¼â æ¯ä¸ªæ¡ä¾é½å ç²æ é¢ â â åå¹¶æµç åè¿°
- 设é®å¼å¤´ï¼â “为ä»ä¹ä¼è¿æ ·ï¼” â â ç´æ¥è¯´åå
- é夿»ç»ï¼â “æ»ä¹ãç»¼ä¸æè¿°ãè¿æå³ç” â â çç¥æç²¾ç®
- è¿åº¦è§£éï¼â æ¯ä¸ªæ¦å¿µé½å±å¼è¯´æ â â åè®¾è¯»è æåºç¡
ç¨æ·è¯´”太å°å¦”æ¶ï¼ç«å»ç²¾ç®ï¼ä¸è¦è§£éã
ç´ æå¤ç
å¦æç¨æ·æä¾äºç´ ææä»¶ï¼
- ç´æ¥è¯»å
- æåå ³é®ä¿¡æ¯
- ä¸è¦è¿åº¦è¯¢é®ï¼ç´æ¥è¿å ¥ä¸ä¸é¶æ®µ
妿éè¦è¡¥å ä¿¡æ¯ï¼
- å¯ä»¥æç´¢äºèç½è·åçé¨è§ç¹ãæ¡ä¾ãæ°æ®
- ä¸»å¨æç´¢ï¼ä¸è¦æ¯æ¬¡é½é®”è¦ä¸è¦æç´¢”
éåºæ¡ä»¶
ç¨æ·åçå®å ä¿¡æ¯é®é¢åï¼ç´æ¥è¿å ¥ Stage 2ï¼ä¸è¦åå¤ç¡®è®¤ã
Stage 2: Refinement & Structure
ç®æ ï¼ éç« è头è飿´ãçéãæ°åãè¿ä»£ã
ç¡®å®ç»æ
æ ¹æ®ææ¡£ç±»å建议 3-6 ä¸ªç« èï¼å建æä»¶æ¡æ¶ï¼Markdown æä»¶ï¼ï¼ç¨ [å¾
æ°å] å ä½ã
æ¯ç« èæµç¨
Step 1: 头è飿´
ååº 8-15 个å¯è½å å«çç¹ï¼ç¼å·åç°ã
**N 个å¯è½å
å«çç¹ï¼**
1. xxx
2. xxx
...
**ä¿çåªäºï¼** æ¯å¦ï¼`1ã3ã5ã7`
Step 2: çé
ç¨æ·åå¤éæ©åï¼
- å¦æç¨æ·è¯´”å ¨é¨”æ”1-N”ï¼ç´æ¥å ¨é¨éç¨ï¼ä¸å确认
- å¦æç¨æ·éæ©é¨åï¼åªç¨éä¸ç
- ä¸è¦è¿½é®”ç¡®å®å”ï¼ç´æ¥è¿å ¥æ°å
Step 3: æ°å
æ ¹æ®çéç»ææ°åè¯¥ç« èï¼ç´æ¥æ´æ°æä»¶ã
æ°å宿åï¼
- å±ç¤ºè¯¥ç« èå 容ï¼å¼ç¨åæ ¼å¼ï¼
- ç®ç询é®ï¼”ææ³æ¹çåï¼æ²¡é®é¢å°±ãç»§ç»ã”
Step 4: è¿ä»£
ç¨æ·åé¦å¤çè§åï¼
| ç¨æ·è¯´ | è¡å¨ |
|---|---|
| “ç»§ç»” | è¿å ¥ä¸ä¸ç« è |
| “太å°å¦” | ç«å»ç²¾ç®ï¼ä¸è§£é |
| “ä¸è¦xxxå¥å¼” | è®°ä½ï¼åç»ç« èä¹éµå® |
| å ·ä½ä¿®æ¹æè§ | æ§è¡ä¿®æ¹ï¼å±ç¤ºç»æ |
è¿ä»£è¦å¿«ã ç¨æ·ç»åé¦åç«å»æ¹ï¼æ¹å®ç«å»å±ç¤ºï¼ä¸è¦é¿ç¯è§£éã
飿 ¼å¦ä¹
å¨è¿ä»£è¿ç¨ä¸è®°ä½ç¨æ·ç飿 ¼å好ï¼
- ç¨æ·å æäºä»ä¹ â åç»é¿å
- ç¨æ·è¯´”太å°å¦” â åç»æ´ç²¾ç®
- ç¨æ·è¯´”ä¸è¦èªé®èªç” â ææç« èé½é¿å
宿ææç« èå
è¾åºå ¨æä¾ç¨æ·é读ï¼è¯¢é®æ¯å¦éè¦è°æ´ã
Stage 3: Reader Testingï¼å¯éï¼
ç®æ ï¼ ç¨æ°é²è§è§æ£æ¥ææ¡£æ¯å¦æ¸ æ°ã
ä» å½ç¨æ·è¦æ±æ¶æ§è¡ï¼æææ¡£è¾é¿/è¾å¤ææ¶å»ºè®®ã
æ§è¡æ¹å¼
- 颿µè¯»è å¯è½çé®é¢ï¼5-10 个ï¼
- ç¨ sub-agent æå»ºè®®ç¨æ·å¼æ°å¯¹è¯æµè¯
- åç°é®é¢ååå° Stage 2 ä¿®å¤
æ ¸å¿åå
æçä¼å
- ä¸è¦åå¤ç¡®è®¤ï¼ç¨æ·è¯´äºå°±æ§è¡
- 头è飿´åç¨æ·é”å ¨é¨”å°±ç´æ¥ç¨
- è¿ä»£è¦å¿«ï¼æ¹å®å°±å±ç¤º
飿 ¼ä¸è´
- 第ä¸ç« ç¡®å®ç飿 ¼ï¼åç»ç« èé½éµå®
- ç¨æ·çä¿®æ¹åé¦è¦è®°ä½ï¼ä¸¾ä¸åä¸
ç²¾ç®è¡¨è¾¾
- å±ç¤ºå 容ç¨å¼ç¨åï¼ç®æ´
- è¿æ¸¡è¯ä¸å¥è¯ï¼”ç»§ç»ï¼” “ææ³æ¹çåï¼”
- ä¸è¦é¿ç¯è§£éæµç¨
常è§åé¦çå¿«éååº
| ç¨æ·è¯´ | ç«å»å |
|---|---|
| “太å°å¦” | ç²¾ç® 50%ï¼ä¸è§£é |
| “ä¸è¦èªé®èªç” | éåï¼å»æææè®¾é®å¥ |
| “åå¹¶èµ·æ¥å” | 廿尿 é¢ï¼æµç åè¿° |
| “ç»§ç»” | ä¸ä¸ç« è |
| “è¾åºå ¨æ” | 读åæä»¶ï¼å®æ´å±ç¤º |