产品与设计
仓库接入 CodeStable:创建最小骨架并处理 v1…
为仓库接入 CodeStable 时创建最小骨架,或为 v1 存量项目做无损升级说明。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
仓库接入 CodeStable:创建最小特定
解决思路
- 为仓库创建最小 CodeStable 骨架:在 `.codestable/` 下建立 `attention.md`、`lessons/` 和 `work/`。
- `attention.md` 用于存放每次会话必读的项目事实,最多 25 条,从空开始。
- `lessons/` 用于沉淀经验,一条经验一个文件,由 `cs-keep` 写入。
- `work/` 用于存放活动中的跨会话任务文档,任务完成即清理。
- 创建后确认 `.codestable/` 未被 `.gitignore` 忽略(它必须入库共享);发现被忽略时停下报告,由用户决定怎么改,不擅自修改 `.gitignore`。
- `attention.md` 初始只写一行标题和一句用途说明,不预置分节模板。
- `.codestable/epics/` 不属于基础骨架:首次 Epic 优先沿用项目已有 Epic / RFC / initiative 归宿,没有时才由 `cs-epic` 按需创建。
- 存量文件一律不动:v1 知识目录 `.codestable/roadmap/`、`.codestable/features/`、`.codestable/issues/`、`.codestable/refactors/`、`.codestable/goals/`、`.codestable/compound/`、`.codestable/audits/`、`.codestable/brainstorms/`、`.codestable/feedback/`,既有 `.codestable/requirements/`,以及旧版运行时(legacy runtime)资产 `.codestable/reference/`、`.codestable/tools/`、`.codestable/gates/`、`.codestable/hooks/`、`.codestable/runtime-manifest.json` 全部原样保留,不删除、不覆盖、不迁移格式。
- 上述 9 个 v1 知识目录及其他未被 v2 明确拥有的既有 `.codestable/` 目录默认只读:不得继续生成、原地改写或批量迁移。
- 新结论进入 v2 Epic、项目文档、ADR 或经验(lesson)。
- 拥有任务的技能(owning task skills)只按当前任务关键词检索存在的历史目录,命中时报告来源路径。
- 既有 `.codestable/requirements/` 仅在 `.codestable/attention.md` 明确记录其为规范需求(canonical requirement)位置时可继续维护;owner 首次指定时先记录到 attention,否则按只读历史处理;目录不存在时不默认创建。
- 不复制任何 skill 包内文件到项目;v1 的 `reference/gates/tools` 分发机制已废止。
- 已有 `.codestable/` 的仓库只补缺失的 `attention.md`、`lessons/` 与 `work/`,其余不碰。
- 对存量 v1 项目,创建缺失目录后向用户说明:旧产物与旧沉淀全部保留;拥有任务的技能按任务关键词只读检索存在的历史目录并报告命中路径。
- 对存量 v1 项目,向用户说明:新工作不再生成 v1 形态产物(阶段文档、检查清单、目标包),普通任务零产物,跨会话任务一个 work 文档。
- 对存量 v1 项目,向用户说明:门禁(gate)与运行时(runtime)工具不再由 skill 调用;项目侧 `.codestable/tools/` 若被用户自己的钩子(hook)引用则继续自行维护。
- 收尾时报告创建了哪些文件、保留了哪些存量、`.codestable/` 的 git 状态。
- 不写入任何业务判断。
- 规则和纪律放在 skill 包里,项目目录只放项目自己的知识。
适用边界 · 注意事项
- 不适用于非 CodeStable 仓库或不需要 CodeStable 骨架/升级说明的场景。
- 不适用于需要删除、覆盖、迁移或批量改写 v1 存量文件与旧版运行时资产的场景。
- 不适用于需要把 skill 包内 `reference/gates/tools` 等文件复制进项目的场景。