156 lines
4.4 KiB
Markdown
156 lines
4.4 KiB
Markdown
|
# /athena-migrate (Codex) — v9.5 → v9.6 迁移
|
||
|
|
|
||
|
|
参考 CC 版 `~/.claude/skills/athena-migrate/SKILL.md`. 算法一致 (因为 schema 跨平台相同, 这是铁律 6).
|
||
|
|
|
||
|
|
Codex 端差异:
|
||
|
|
- 用 python3 替代 node 生成 `_index.md` (Codex 默认有 python3)
|
||
|
|
- 检测 `cx_version` 写入 `platform_features.cx_version`, **不写** cc_version
|
||
|
|
|
||
|
|
## 备份脚本
|
||
|
|
|
||
|
|
```bash
|
||
|
|
mkdir -p .ai_state/.legacy-v9.5
|
||
|
|
cp -r .ai_state/{tasks.md,design.md,progress.md,lessons.md,handoff.md,project.json,reviews,hook-trace.jsonl} .ai_state/.legacy-v9.5/ 2>/dev/null || true
|
||
|
|
```
|
||
|
|
|
||
|
|
## 创建 details/
|
||
|
|
|
||
|
|
```bash
|
||
|
|
mkdir -p .ai_state/details/reviews .ai_state/details/tasks-archive
|
||
|
|
```
|
||
|
|
|
||
|
|
## 平移
|
||
|
|
|
||
|
|
```bash
|
||
|
|
[ -f .ai_state/tasks.md ] && mv .ai_state/tasks.md .ai_state/details/tasks-current.md
|
||
|
|
for f in design.md progress.md lessons.md handoff.md; do
|
||
|
|
[ -f .ai_state/$f ] && mv .ai_state/$f .ai_state/details/$f
|
||
|
|
done
|
||
|
|
[ -d .ai_state/reviews ] && mv .ai_state/reviews .ai_state/details/reviews
|
||
|
|
[ -f .ai_state/compact-snapshot.json ] && rm .ai_state/compact-snapshot.json # Codex 无 compact 也能有的旧文件
|
||
|
|
```
|
||
|
|
|
||
|
|
## 生成 _index.md (python3)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
python3 << 'PY'
|
||
|
|
import json, os, re, sys
|
||
|
|
|
||
|
|
proj = {}
|
||
|
|
try:
|
||
|
|
with open('.ai_state/.legacy-v9.5/project.json') as f:
|
||
|
|
proj = json.load(f)
|
||
|
|
except FileNotFoundError:
|
||
|
|
pass
|
||
|
|
|
||
|
|
def count_match(path, pattern):
|
||
|
|
try:
|
||
|
|
with open(path) as f:
|
||
|
|
return len(re.findall(pattern, f.read(), re.MULTILINE))
|
||
|
|
except FileNotFoundError:
|
||
|
|
return 0
|
||
|
|
|
||
|
|
def last_section_line(path, head_prefix='## '):
|
||
|
|
try:
|
||
|
|
lines = open(path).read().split('\n')
|
||
|
|
for i in range(len(lines) - 1, -1, -1):
|
||
|
|
if lines[i].startswith(head_prefix):
|
||
|
|
return i + 1
|
||
|
|
except FileNotFoundError:
|
||
|
|
pass
|
||
|
|
return 0
|
||
|
|
|
||
|
|
def last_nonempty_line(path):
|
||
|
|
try:
|
||
|
|
lines = open(path).read().split('\n')
|
||
|
|
for i in range(len(lines) - 1, -1, -1):
|
||
|
|
stripped = lines[i].strip()
|
||
|
|
if stripped and not stripped.startswith('<!--') and not stripped.startswith('#'):
|
||
|
|
return i + 1
|
||
|
|
except FileNotFoundError:
|
||
|
|
pass
|
||
|
|
return 0
|
||
|
|
|
||
|
|
tasks_pending = count_match('.ai_state/details/tasks-current.md', r'^- \[ \]')
|
||
|
|
tasks_done = count_match('.ai_state/details/tasks-current.md', r'^- \[x\]')
|
||
|
|
progress_n = last_nonempty_line('.ai_state/details/progress.md')
|
||
|
|
lessons_lines = count_match('.ai_state/details/lessons.md', r'^## ')
|
||
|
|
latest_lesson_line = last_section_line('.ai_state/details/lessons.md')
|
||
|
|
|
||
|
|
reviews = []
|
||
|
|
try:
|
||
|
|
reviews = [f for f in os.listdir('.ai_state/details/reviews') if re.match(r'^sprint-\d+\.md$', f)]
|
||
|
|
except FileNotFoundError:
|
||
|
|
pass
|
||
|
|
reviews_count = len(reviews)
|
||
|
|
latest_review = ''
|
||
|
|
if reviews:
|
||
|
|
latest_review = 'details/reviews/' + sorted(reviews, key=lambda f: int(re.search(r'\d+', f).group()))[-1]
|
||
|
|
|
||
|
|
content = f'''---
|
||
|
|
schema_version: "9.6"
|
||
|
|
athena_version: "9.6.0"
|
||
|
|
project:
|
||
|
|
path: "{proj.get('path','')}"
|
||
|
|
stage: "{proj.get('stage','')}"
|
||
|
|
sprint: {proj.get('sprint', 0)}
|
||
|
|
active_goal: ""
|
||
|
|
counts:
|
||
|
|
tasks_pending: {tasks_pending}
|
||
|
|
tasks_done: {tasks_done}
|
||
|
|
tasks_blocked: 0
|
||
|
|
lessons_lines: {lessons_lines}
|
||
|
|
progress_entries: {progress_n}
|
||
|
|
reviews_count: {reviews_count}
|
||
|
|
pointers:
|
||
|
|
latest_progress: "{('details/progress.md#L' + str(progress_n)) if progress_n else ''}"
|
||
|
|
latest_review: "{latest_review}"
|
||
|
|
latest_lesson: "{('details/lessons.md#L' + str(latest_lesson_line)) if latest_lesson_line else ''}"
|
||
|
|
latest_proposal: ""
|
||
|
|
fingerprints:
|
||
|
|
tasks_mtime: 0
|
||
|
|
design_mtime: 0
|
||
|
|
progress_mtime: 0
|
||
|
|
lessons_mtime: 0
|
||
|
|
platform_features:
|
||
|
|
cc_version: ""
|
||
|
|
cx_version: ""
|
||
|
|
goal_supported: false
|
||
|
|
batch_supported: false
|
||
|
|
background_supported: false
|
||
|
|
session_memory_active: false
|
||
|
|
cross_session_memory: "none"
|
||
|
|
gotchas: {json.dumps(proj.get('gotchas', []))}
|
||
|
|
conventions: {json.dumps(proj.get('conventions', []))}
|
||
|
|
tech_stack: "{proj.get('tech_stack','')}"
|
||
|
|
test_cmd: "{proj.get('test_cmd','')}"
|
||
|
|
build_cmd: "{proj.get('build_cmd','')}"
|
||
|
|
lint_cmd: "{proj.get('lint_cmd','')}"
|
||
|
|
dev_cmd: "{proj.get('dev_cmd','')}"
|
||
|
|
---
|
||
|
|
|
||
|
|
# 项目状态索引 (v9.6 migrated from v9.5.5)
|
||
|
|
|
||
|
|
## 最近活动
|
||
|
|
|
||
|
|
## 当前阻塞
|
||
|
|
|
||
|
|
## 下一动作 (PACE 建议)
|
||
|
|
|
||
|
|
## 反思建议 (Hook 沉淀)
|
||
|
|
'''
|
||
|
|
|
||
|
|
with open('.ai_state/_index.md', 'w') as f:
|
||
|
|
f.write(content)
|
||
|
|
print('[migrate] _index.md generated')
|
||
|
|
PY
|
||
|
|
```
|
||
|
|
|
||
|
|
## 收尾
|
||
|
|
|
||
|
|
```bash
|
||
|
|
touch .ai_state/details/next.md .ai_state/details/proposals.md
|
||
|
|
git add .ai_state/
|
||
|
|
git commit -m "athena: migrate state to v9.6 schema (codex)"
|
||
|
|
```
|