qiusuo0226/chrono-pm-skill / governance-shared/baselines/1.17.0
1.17.0
Verifiedreferences/20-workspace-version-rules.md
View on GitHub---
rule_id: 20
title: 宸ヤ綔鍖虹増鏈笌杩佺Щ瑙勫垯
category: 宸ヤ綔鍖虹鐞?risk_level: 涓?depends_on: [00]
version: 1.0
---
# 20 宸ヤ綔鍖虹増鏈笌杩佺Щ瑙勫垯
鏈鍒欏畾涔夊伐浣滃尯鐗堟湰鍏煎鎬ф鏌ャ€佸仴搴锋鏌ャ€佽縼绉绘ā寮忓拰鍏煎妯″紡鐨勮涓鸿鑼冦€?
## 1. 宸ヤ綔鍖虹増鏈鏌?
AI 鍦ㄨ繘鍏ヤ换浣曞伐浣滃尯鐨勫鐞嗘祦绋嬪墠锛?*蹇呴』鍏堣鍙?`ai/.skill-version.json`**锛堝瀛樺湪锛夛紝鑾峰彇浠ヤ笅淇℃伅锛?
| 瀛楁 | 璇存槑 |
|---|---|
| `skillVersion` | 璇ュ伐浣滃尯鍒濆鍖栨椂浣跨敤鐨?Skill 鐗堟湰 |
| `workspaceSchemaVersion` | 璇ュ伐浣滃尯鐨勭洰褰曠粨鏋勭増鏈?|
| `mode` | 宸ヤ綔鍖烘ā寮忥紙single / portfolio锛墊
| `initializedAt` | 鍒濆鍖栨椂闂?|
| `lastMigratedAt` | 鏈€杩戜竴娆¤縼绉绘椂闂达紙null 琛ㄧず浠庢湭杩佺Щ锛墊
**鐗堟湰鍏煎鎬у垽鏂鍒欙細**
1. AI 璇诲彇 Skill 鍖呬腑鐨?`VERSION` 鏂囦欢鑾峰彇褰撳墠 Skill 鐗堟湰銆?2. 瀵规瘮褰撳墠 Skill 鐗堟湰涓庡伐浣滃尯鐨?`skillVersion`銆?3. 鏍规嵁 `CHANGELOG.md` 涓殑 Upgrade Notes 鍒ゆ柇鏄惁闇€瑕佽縼绉汇€?4. 鎸変互涓嬬瓥鐣ュ鐞嗭細
| 鐗堟湰宸紓鎯呭喌 | AI 琛屼负 |
|---|---|
| 鐗堟湰涓€鑷?| 姝e父澶勭悊 |
| Skill 鐗堟湰鏇存柊浣?schema 鏈彉 | 鎸夋柊瑙勫垯澶勭悊锛屾彁绀虹敤鎴?褰撳墠瑙勫垯鐗堟湰涓?x.x.x锛屽伐浣滃尯鐢?x.x.x 鍒濆鍖栵紝瑙勫垯宸插崌绾т絾鐩綍缁撴瀯鏃犻渶杩佺Щ" |
| schema 鐗堟湰涓嶅悓 | 鎻愮ず鐢ㄦ埛闇€瑕佽縼绉伙紝杈撳嚭杩佺Щ寤鸿锛屼笉鑷鎵ц杩佺Щ |
| 鏃?.skill-version.json | 鎻愮ず"鏈娴嬪埌鐗堟湰鏂囦欢锛屽彲鑳界敱鏃х増鏈垵濮嬪寲銆傚缓璁繍琛?init_workspace.py 閲嶆柊鍒濆鍖栨垨鎵嬪姩鍒涘缓鐗堟湰鏂囦欢" |
**鐗堟湰涓嶅尮閰嶆椂鐨勬彁绀烘牸寮忥細**
```markdown
## 鐗堟湰鍏煎鎬ф娴?
- 褰撳墠 Skill 鐗堟湰锛歔鐗堟湰鍙穄
- 宸ヤ綔鍖哄垵濮嬪寲鐗堟湰锛歔鐗堟湰鍙穄
- Workspace Schema 鐗堟湰锛歔鐗堟湰鍙穄
- 宸紓璇存槑锛歔鏍规嵁 CHANGELOG.md 鐨?Upgrade Notes 璇存槑宸紓]
- 鏄惁闇€瑕佽縼绉伙細鏄?/ 鍚?- 杩佺Щ寤鸿锛歔濡傞渶瑕侊紝鍒楀嚭杩佺Щ姝ラ]
```
**瑙勫垯锛?*
1. AI 涓嶅緱鍦ㄧ増鏈笉鍖归厤鏃惰嚜琛屾墽琛岃縼绉绘搷浣滐紝蹇呴』杈撳嚭杩佺Щ寤鸿鐢辩敤鎴风‘璁ゃ€?2. AI 鍦ㄧ増鏈笉鍖归厤浣嗕粛鍙甯稿鐞嗘椂锛坰chema 鏈彉锛夛紝搴旀寜鏂拌鍒欏鐞嗭紝鍚屾椂鎻愮ず鐗堟湰宸紓銆?3. 杩佺Щ瀹屾垚鍚庯紝鐢ㄦ埛闇€鏇存柊 `.skill-version.json` 涓殑 `lastMigratedAt` 瀛楁銆?4. 杩佺Щ鍘嗗彶璁板綍鍦?`ai/logs/migration-log.md` 涓€?
## 2. 宸ヤ綔鍖哄仴搴锋鏌ワ紙姣忔浼氳瘽棣栨浜や簰鏃舵墽琛岋級
AI 鍦ㄦ瘡娆′細璇?*棣栨杩涘叆宸ヤ綔鍖?*鏃讹紙鑰岄潪姣忔璇锋眰锛夛紝蹇呴』鎵ц宸ヤ綔鍖哄仴搴锋鏌ワ細
**妫€鏌ユ楠わ細**
1. 璇诲彇 `ai/.skill-version.json`锛岃幏鍙?`skillVersion` 鍜?`workspaceSchemaVersion`銆?2. 璇诲彇 Skill 鍖?`VERSION` 鏂囦欢锛岃幏鍙栧綋鍓?Skill 鐗堟湰銆?3. 濡傛灉鐗堟湰涓嶄竴鑷达紝鎸夌増鏈樊璺濇鏌ヤ互涓嬪唴瀹规槸鍚﹀瓨鍦細
| 鐗堟湰鑼冨洿 | 妫€鏌ラ」 |
|---|---|
| 0.3.0+ | `portfolio/resources/resource-register.md` 鍜?`transfer-log.md` 鏄惁瀛樺湪 |
| 0.4.0+ | `context/project-brief.md` 鏄惁瀛樺湪 |
| 0.5.0+ | `outputs/` 鐩綍鏄惁瀛樺湪 |
| 0.7.0+ | `reports/daily/personal/summaries/` 鐩綍鏄惁瀛樺湪锛涙槸鍚﹁繕鍦ㄧ敤 `YYYY/MM` 鏃х粨鏋?|
| 0.8.0+ | `continuity/` 鐩綍鍜?4 涓枃浠舵槸鍚﹀瓨鍦?|
| 0.9.0+ | `portfolio/todos/` 鐩綍鏄惁瀛樺湪 |
| 1.1.0+ | `portfolio/todos/snapshots/` 鍜?`portfolio/todos/actuals/` 鐩綍鏄惁瀛樺湪 |
| 1.1.0+ | `portfolio/todos/history-index.md` 鏄惁瀛樺湪 |
| 1.9.0+ | `portfolio/context/pm-profile.md`锛堥」鐩泦妯″紡锛夋垨 `context/pm-profile.md`锛堝崟椤圭洰妯″紡锛夋槸鍚﹀瓨鍦?|
4. 濡傚彂鐜扮己澶憋紝杈撳嚭宸ヤ綔鍖哄仴搴锋姤鍛娿€?
**鍋ュ悍妫€鏌ヨ緭鍑烘牸寮忥細**
```markdown
## 宸ヤ綔鍖哄仴搴锋鏌?
- 褰撳墠 Skill 鐗堟湰锛?.2.0
- 宸ヤ綔鍖虹増鏈細0.8.0
- Schema 鐗堟湰锛?.4.0 鈫?褰撳墠 0.5.0
### 缂哄け鑳藉姏
| 鐗堟湰 | 鑳藉姏 | 缂哄け椤?| 褰卞搷 |
|---|---|---|---|
| 0.9.0 | 蹇€熸煡璇?寰呭姙绱㈠紩 | portfolio/todos/ 鐩綍 | 鏌ヨ寰呭姙鏃朵細鍥為€€鍒板叏閲忔壂鎻?|
| 1.1.0 | 璁″垝蹇収 | snapshots/actuals 鐩綍 | 鏃犳硶鍥炴煡鍘嗗彶璁″垝鍜屽亸宸?|
### 寤鸿
妫€娴嬪埌宸ヤ綔鍖虹増鏈惤鍚庯紝缂哄皯 2 涓兘鍔涙ā鍧椼€?
鎵ц杩佺Щ锛?```
python scripts/migrate_workspace.py --project-root .
```
鎴栧厛鏌ョ湅宸紓锛堜笉鎵ц锛夛細
```
python scripts/migrate_workspace.py --project-root . --dry-run
```
鏄惁鐜板湪鎵ц杩佺Щ锛?```
**瑙勫垯锛?*
1. 鍋ュ悍妫€鏌ュ湪姣忔浼氳瘽棣栨浜や簰鏃舵墽琛岋紝涓嶉噸澶嶆墽琛屻€?2. 濡傜増鏈竴鑷翠笖鑳藉姏瀹屾暣锛屼笉杈撳嚭鍋ュ悍鎶ュ憡锛岀洿鎺ユ甯稿鐞嗐€?3. 濡傜増鏈笉涓€鑷翠絾鏈夌己澶憋紝蹇呴』杈撳嚭鍋ュ悍鎶ュ憡鍜屽缓璁€?4. AI 涓嶅緱鑷鎵ц杩佺Щ锛屽繀椤荤敱鐢ㄦ埛纭銆?5. 濡傜敤鎴锋嫆缁濊縼绉伙紝AI 鎸夊綋鍓嶅彲鐢ㄧ殑鑳藉姏澶勭悊锛岀己澶辫兘鍔涚敤鍏滃簳閫昏緫鏇夸唬銆?
## 3. 鍔熻兘瑙﹀彂鏃舵鏌ワ紙Feature-Triggered Check锛?
褰撶敤鎴疯Е鍙戞煇涓渶瑕佺壒瀹氱洰褰?鏂囦欢鐨勮兘鍔涳紝浣嗚鐩綍/鏂囦欢涓嶅瓨鍦ㄦ椂锛孉I 涓嶅緱鐩存帴閫€鍖栦负鍏ㄩ噺鎵弿锛屽繀椤诲厛鎻愮ず宸ヤ綔鍖哄彲鑳芥湭鍗囩骇锛?
**绀轰緥锛氱敤鎴烽棶"鎴戞槑澶╃殑寰呭姙鏄粈涔?锛屼絾 `portfolio/todos/personal-todo-index.md` 涓嶅瓨鍦?*
AI 搴旇緭鍑猴細
```markdown
鎴戝噯澶囨寜蹇€熸煡璇㈣鍒欒鍙?PM 寰呭姙绱㈠紩锛屼絾褰撳墠宸ヤ綔鍖虹己灏戯細
`ai/portfolio/todos/personal-todo-index.md`
杩欓€氬父琛ㄧず褰撳墠 `ai/` 鐩綍杩樺仠鐣欏湪鏃х増鏈粨鏋勩€?
褰撳墠寤鸿锛?1. 鍏堟墽琛屽伐浣滃尯鍗囩骇妫€鏌?2. 琛ラ綈 `ai/portfolio/todos/` 绱㈠紩鐩綍
3. 鍙€変粠鏈€杩?7 澶╂棩鎶ラ噸寤哄緟鍔炵储寮?4. 鍐嶅洖绛?鏄庡ぉ寰呭姙"
鏄惁鐜板湪鐢熸垚鍗囩骇璁″垝锛?
濡傛灉浣犳殏鏃朵笉鍗囩骇锛屾垜涔熷彲浠ヨ繘鍏ュ吋瀹规ā寮忥紝浠庝换鍔$湅鏉垮拰鏈€杩戞棩鎶ョ储寮曚腑鏌ヨ锛屼絾浼氭洿鎱笖鍙兘涓嶅畬鏁淬€?```
**瑙勫垯锛?*
1. 涓嶅緱鍦ㄧ己灏戠储寮曟椂鐩存帴鍒涘缓涓存椂鑴氭湰鍏ㄩ噺鎵弿銆?2. 蹇呴』鍏堟彁绀哄伐浣滃尯鍙兘鏈崌绾с€?3. 鎻愮ず鍚庣敤鎴峰彲閫夋嫨锛氬崌绾?/ 鍏煎妯″紡 / 鍙栨秷銆?
## 4. 鍏煎妯″紡
褰撶敤鎴烽€夋嫨涓嶅崌绾ф椂锛孉I 杩涘叆鍏煎妯″紡锛?
1. 浣跨敤鏃х洰褰曠粨鏋勫拰鍏滃簳閫昏緫鍥炵瓟銆?2. 鏄庣‘鎻愮ず鏂拌兘鍔涗笉鍙敤鎴栨€ц兘杈冧綆銆?3. 涓嶅己琛屼娇鐢ㄦ柊鐗堣矾寰勩€?4. 鍦ㄥ繀瑕佹椂鎻愰啋鍙崌绾с€?
**鍏煎妯″紡鎻愮ず鏍煎紡锛?*
```markdown
鈿狅笍 鍏煎妯″紡
褰撳墠宸ヤ綔鍖烘湭鍗囩骇鍒版渶鏂扮増鏈紝浠ヤ笅鑳藉姏闄嶇骇杩愯锛?- 蹇€熸煡璇細閫€鍖栦负璇讳换鍔$湅鏉?+ 鏃ユ姤绱㈠紩锛堣緝鎱級
- 璁″垝蹇収锛氫笉鍙敤
- PM 寰呭姙鍏ㄦ櫙瑙嗗浘锛氫粎鍒楀嚭 PM 涓汉浠诲姟
濡傞渶浣跨敤瀹屾暣鑳藉姏锛岃鎵ц锛?python scripts/migrate_workspace.py --project-root .
```
## 5. 鍏滃簳閫昏緫
褰撳伐浣滃尯缂哄皯鏌愪簺鑳藉姏瀵瑰簲鐨勭洰褰?鏂囦欢鏃讹紝AI 涓嶅緱鎶ラ敊涓柇锛屾寜浠ヤ笅鍏滃簳绛栫暐澶勭悊锛?
| 缂哄け鑳藉姏 | 鍏滃簳绛栫暐 |
|---|---|
| todos/ 绱㈠紩缂哄け | 閫€鍖栦负璇诲彇 `tasks/board.md` + 鏈€杩戞棩鎶ョ储寮曪紝浣嗘彁绀鸿緝鎱?|
| snapshots/ 缂哄け | 閫€鍖栦负璇诲彇鏃ユ姤绱㈠紩锛屼絾鎻愮ず鏃犳硶瀵规瘮璁″垝鍋忓樊 |
| continuity/ 缂哄け | 璺宠繃鍘嗗彶琛旀帴鍔熻兘锛屾彁绀虹敤鎴峰垵濮嬪寲 |
| project-brief.md 缂哄け | 閫€鍖栦负璇诲彇 project-context.md |
| summaries/ 缂哄け | 閫€鍖栦负閫愭棩鎵弿璇ヤ汉鏃ユ姤 |
| outputs/ 缂哄け | 鍦ㄥ伐浣滃尯鏍圭洰褰曚笅鑷姩鍒涘缓 |
| pm-profile.md 缂哄け | 璺宠繃鍋忓ソ鍔犺浇锛屾寜榛樿琛屼负澶勭悊锛屾彁绀烘墽琛?`migrate_workspace.py --create-profile` 琛ュ缓锛屼笉闃诲 |
## 6. 鍗囩骇鎻愰啋棰戠巼鎺у埗
AI 涓嶅緱姣忔閮界儲鐢ㄦ埛銆傚崌绾ф彁閱掗鐜囬€氳繃 `.workspace-health.md` 鎺у埗锛?
| 瀛楁 | 璇存槑 |
|---|---|
| `last_prompted_upgrade_at` | 涓婃鎻愰啋鏃堕棿 |
| `ignored_until` | 蹇界暐鎴鏃堕棿锛堢敤鎴烽€夋嫨"鏆備笉鎻愰啋"鏃惰缃級 |
**瑙勫垯锛?*
1. 濡?`ignored_until` 鏈埌锛屼笉閲嶅鎻愰啋銆?2. 鐢ㄦ埛閫夋嫨"鏆備笉鎻愰啋涓€鍛?鏃讹紝璁剧疆 `ignored_until` 涓?7 澶╁悗銆?3. 濡傜敤鎴蜂富鍔ㄩ棶"妫€鏌ュ伐浣滃尯鍋ュ悍"锛屼笉鍙?`ignored_until` 闄愬埗銆?
## 7. 鍗囩骇瑙﹀彂璇?
褰撶敤鎴疯緭鍏ュ寘鍚互涓嬭〃杈炬椂锛屽繀椤昏Е鍙戝伐浣滃尯鍗囩骇妫€鏌ワ細
- 妫€鏌ュ伐浣滃尯鐗堟湰 / 妫€鏌?ai 鐩綍鏄惁闇€瑕佸崌绾?- 鍗囩骇褰撳墠 ai 宸ヤ綔鍖?/ 杩佺Щ鍒版渶鏂扮増 Skill
- 鍚屾鏈€鏂扮増鐩綍缁撴瀯 / 琛ラ綈鏂扮増鐩綍
- 閲嶅缓绱㈠紩 / 妫€鏌ョ储寮曟槸鍚﹀畬鏁?- 涓轰粈涔堟煡璇㈡參 / 涓轰粈涔堟柊鍔熻兘涓嶈兘鐢?/ 涓轰粈涔堟壘涓嶅埌寰呭姙
- 褰撳墠 ai 宸ヤ綔鍖哄仴搴峰悧 / 宸ヤ綔鍖虹姸鎬?
## 8. 宸ヤ綔鍖哄仴搴锋枃浠?
鍗囩骇妫€鏌ユ垨杩佺Щ瀹屾垚鍚庯紝搴旂淮鎶?`ai/.workspace-health.md`锛岃褰曪細
- 鐗堟湰鐘舵€?- 鑳藉姏鐘舵€侊紙ok / missing / degraded锛?- 绱㈠紩鐘舵€侊紙fresh / stale / empty / missing锛?- 鎺ㄨ崘鍔ㄤ綔
- 鍗囩骇鎻愰啋鎺у埗
AI 妫€鏌?宸ヤ綔鍖哄仴搴峰悧"鏃朵紭鍏堣鍙栨湰鏂囦欢銆?
## 9. 杩佺Щ妯″紡
宸ヤ綔鍖鸿縼绉绘敮鎸佷互涓嬫ā寮忥細
| 妯″紡 | 璇存槑 | 椋庨櫓 | 榛樿 |
|---|---|---|---|
| `diagnosis-only` | 鍙瘖鏂笉淇敼 | 鏃?| - |
| `structure-only` | 鍙垱寤虹己澶辩洰褰曞拰绌虹储寮?| 浣?| 鉁?|
| `recent-7-days` | 鍒涘缓鐩綍 + 浠庢渶杩?7 澶╅噸寤虹储寮?| 涓?| 鉁?鎺ㄨ崘鎼厤 |
| `current-month` | 浠庡綋鍓嶆湀鏁版嵁閲嶅缓绱㈠紩 | 涓?| - |
| `full-rebuild` | 鍏ㄩ噺鎵弿閲嶅缓绱㈠紩 | 楂?| 闇€鐢ㄦ埛鏄庣‘瑕佹眰 |
**瑙勫垯锛?*
1. 缁撴瀯杩佺Щ鍜岀储寮曢噸寤哄繀椤诲垎绂汇€?2. 榛樿鎺ㄨ崘 `structure-only` + 鍙€?`recent-7-days`銆?3. 绱㈠紩閲嶅缓蹇呴』璇㈤棶鑼冨洿锛屾湭鑾风‘璁や笉寰楀叏閲忔壂鎻忋€?4. 浜嬪疄婧愭敼鍐欏繀椤诲啀娆$‘璁ゃ€?
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |