| name | cascade-maintain |
| description | 链式维护：当一个源文件变更后，自动检测并更新所有下游关联文件。用户说"帮我维护一下"、"cascade 一下"、"同步一下目录"时触发。适用于 web3career-study-track 项目中任何可能导致多文件联动变更的场景。
|
Cascade Maintain Skill
改了一个文件，链式更新所有下游关联文件。用户不需要记住影响范围，只需要说"帮我维护一下"。
触发场景
- 用户说"帮我维护一下"
- 用户说"cascade 一下"
- 用户说"同步一下目录"
- 用户说"看看有没有要更新的"
- 每篇预习笔记完成后自动触发
工作流程
Step 1：检测变更源
用 git diff 和 git status 扫描当前状态，根据结果进入不同模式：
模式 A：被动追踪（git status 有变更）
识别变更属于哪个源头：
| 变更文件模式 | 归属变更源 |
|---|
pre_study/*/*/README.md | 预习笔记完成 |
daily-log/*/YYYY-MM-DD.md | 每日收尾 |
.Codex/skills/*/SKILL.md | Skill 迭代 |
AGENTS.md 或 steering.md | 规范同步 |
README.md 或 GUIDE.md | 结构变更 |
| 新建周目录 | 跨周切换 |
只检查对应链路的下游文件。
模式 B：主动巡检（git status 干净）
遍历所有 6 条链路，逐一检查一致性。重点检查：
- 周索引中的活动状态是否与实际参加情况一致
- 日索引中的任务状态是否与日志标记一致
- pre_study 状态标记是否与实际完成数一致
- AGENTS.md 与 steering.md 是否对称
Step 2：按链路逐一检查
根据识别到的变更源，按对应链路检查每个下游文件：
链路 A：预习笔记完成
变更源: pre_study/<module>/<Topic>/README.md
↓
1. pre_study/__index__.md → 对应行状态 ⚪→✅ + 模块进度 +1 + 总进度 +1
2. 根 README.md → badge 进度 +1（重算百分比）
+ highlights 数字 +1
+ progress 表对应行 +1 + 合计 +1
+ 更新日期
3. daily-log/week-N/YYYY-MM-DD.md → 产出表追加 2 行（笔记 + 练习）
4. memory/project_prestudy_status.md → 进度数字 +1 + 最新主题更新
5. [模块完成时] 根 README.md gantt 图 → :active → :done
6. [模块完成时] 根 README.md progress 表 → 🟡 → ✅
检查项：
进度数字计算规则：
- badge 百分比 = 已完成/总数，四舍五入到整数（如 31/42 = 73.8% → 74%）
- highlights 数字 = 已完成总数（如 36/42）
- progress 表模块行 = 模块内已完成/模块总数
- progress 表合计行 = 全部已完成/42
链路 B：每日收尾
变更源: daily-log/week-N/YYYY-MM-DD/YYYY-MM-DD.md
↓
1. daily-log/.../__index__.md → 标记 🟢 已完成
2. daily-log/week-N/__index__.md → 周进度条更新
3. git commit → log(week-N): ...
检查项 — 状态同步：
检查项 — 内容完整性（对比 git log 与日志内容）：
链路 C：规范同步
变更源: AGENTS.md 或 steering.md
↓
1. 另一个文件 → 保持对称
- AGENTS.md 改了 → steering.md 跟着改
- steering.md 改了 → AGENTS.md 跟着改
- 差异仅在于：Codex 行为约定 vs Kiro 行为约定
2. memory/ → 如涉及行为偏好，更新 feedback 记忆
检查项：
链路 D：Skill 迭代
变更源: .Codex/skills/<name>/SKILL.md 或 .kiro/skills/<name>/SKILL.md
↓
1. 另一个位置的 skill → 保持同步
- .Codex/skills/ 改了 → .kiro/skills/ 跟着改
- .kiro/skills/ 改了 → .Codex/skills/ 跟着改
2. memory/ → 技能经验沉淀（feedback 类型）
检查项：
链路 E：结构变更
变更源: README.md / GUIDE.md / 新增目录
↓
1. README.md → 目录树同步
2. memory/ → 相关记忆更新
3. git commit → docs: ...
检查项：
链路 F：跨周切换
变更源: 进入新一周
↓
1. daily-log/week-N/WEEK.md → 新周计划
2. daily-log/week-N/__index__.md → 新周索引
3. daily-log/week-(N-1)/__index__.md → 上周收尾检查
4. AGENTS.md 当前阶段 → 阶段标记更新
检查项：
Step 3：执行更新
对每个需要更新的文件：
- 先读取当前内容
- 执行 Edit（级联更新通常不需要用户确认，除非涉及结构性变更）
Step 4：提交
按逻辑分组 commit：
- 笔记批量完成 →
log(日期): 模块名 +N 节完成 — 笔记 + 实践 + 级联同步
- Skill 迭代 →
refactor(skills): 经验沉淀到 skill
- 等待用户确认后 push。
约束
- 不要假设——如果检测不到变更源，问用户
- 不要过度更新——只动链路上的文件，不顺手改无关内容
- 保持对称——AGENTS.md 和 steering.md 必须同步，.Codex/skills 和 .kiro/skills 必须同步
- 进度数字要准——memory 里的进度必须数 actual 已完成的模块数，不靠猜
- badge 百分比要算——不要写错百分比，手动计算后写入
- 模块完成要收尾——gantt 图 + progress 表状态都要更新
