CodeStable 接入向导

将新仓库或已有零散文档的仓库自动接入 CodeStable 体系,支持空仓库骨架搭建和已有文档审计迁移。

O que é CodeStable 接入向导?

该技能自动判断仓库状态,为开发者提供两种接入路径:空仓库直接从零搭建 CodeStable 目录骨架(包括必要的配置文件和目录结构),已有文档仓库则进行文档审计、分类并生成迁移映射,最终将文档整合到 CodeStable 体系中。整个过程无需手动判断,用户只需说出类似“在这个项目里用 CodeStable”、“搭 CodeStable 结构”、“初始化 CodeStable”或“迁移到 CodeStable”等触发语即可。主要面向使用 Claude Code、Cursor 或 Codex 等 AI 编程助手的开发团队,帮助其快速统一项目文档规范,减少上手成本。

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/liuzhengdongfortest/codestable/tree/main/skills/cs-onboard

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que CodeStable 接入向导 faz?

把新仓库或有零散文档的仓库接入 CodeStable 体系,两条路径自动判断:空仓库从零搭骨架,已有文档走审计 + 迁移映射。触发:用户说"在这个项目里用 CodeStable"、"搭 CodeStable 结构"、"初始化 CodeStable"、"迁移到 CodeStable"。

功能描述

该技能能够智能识别仓库当前状态,并执行相应的接入流程:

  • 空仓库:自动创建 CodeStable 所要求的目录结构(如 /docs, /scripts, /configs 等),并生成初始文档模板。
  • 有零散文档的仓库:先扫描已有文档,按内容主题进行审计和分类,然后生成一份迁移映射表,建议文档应该如何移动到 CodeStable 结构下。用户确认后,自动执行移动/重组。

使用方法

在任意仓库目录或对话中,说出以下任意触发语句即可启动:

  • 在这个项目里用 CodeStable
  • 搭 CodeStable 结构
  • 初始化 CodeStable
  • 迁移到 CodeStable

技能会自动分析当前工作目录,并提示下一步操作。

注意事项

  • 请确保已安装并启用 CodeStable 相关依赖。
  • 技能不会删除用户原有文件,只会创建新目录和移动文档(移动前会征求用户同意)。
  • 建议在 git 仓库中执行,以便随时回滚。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

liuzhengdongfortest/cs

CodeStable 工作流根入口,介绍体系全貌并把诉求路由到对应 cs-* 子技能。触发:用户只输入 `cs`、说"介绍一下 codestable"、"该用哪个技能"、"不知道用哪个",或诉求还很开放未收敛。本技能只做路由不做事。

liuzhengdongfortest/cs-arch

维护 `.codestable/architecture/` 这份只记现状的系统地图,三种模式 update / check / backfill。触发:用户说"刷新 architecture"、"做架构检查"、"补这个模块的架构文档"、"方案和代码对得上吗",或 feature 阶段需要先做架构动作。不写未来规划(走 cs-roadmap)。

liuzhengdongfortest/cs-brainstorm

想法还模糊时的讨论入口,做分诊后路由到 feature-design / feature-brainstorm / roadmap。AI 是思考伙伴不是记录员。触发:用户说"有个想法还没想清楚"、"先 brainstorm 一下"、"聊一聊这块"、"方向还在摇摆"。不处理 bug 和重构。

liuzhengdongfortest/cs-decide

把已拍板的技术选型、架构决定、长期约束、编码规约记成永久性决策文档(tech-stack / architecture / constraint / convention 四种)。触发:用户说"记录决定"、"归档技术选型"、"ADR"、"记录这条约束"、"把规约写下来",或 design / analyze 后做出重要选择。只归档已拍板的,讨论中的不归档。

liuzhengdongfortest/cs-explore

对仓库做定向代码探索并把"提问→读代码→得结论"沉淀为可检索证据,三种类型 question / module-overview / spike。触发:用户说"先 explore 一下"、"这个仓库里 X 怎么实现"、"快速熟悉这个模块"、"把探索结果存档"。

liuzhengdongfortest/cs-feat

新功能开发的子流程入口,把"加个 X 能力"从想法走到验收闭环。触发:用户说"做新功能"、"加个 X"、"实现 XX"。只做路由,根据已有产物决定走 brainstorm / design / fastforward / implement / acceptance。不处理 bug。

liuzhengdongfortest/cs-feat-accept

feature 流程阶段 3——验收闭环:对照 design 核实现 + 回写 architecture / requirement / roadmap,最后产出 {slug}-acceptance.md。触发:用户说"功能写完了验收一下"、"做最后检查"、"准备 merge"、"出验收报告"。前置依赖 cs-feat-impl 完成。

liuzhengdongfortest/cs-feat-design

feature 流程阶段 1——为新功能起草 {slug}-design.md 作为后续实现和验收的唯一输入,拍板后抽出 checklist。触发:用户说"开始设计方案"、"写 design doc"、"准备实现 XX",前提是已知道做什么、为谁、怎么算成功。

liuzhengdongfortest/cs-feat-ff

feature 流程的超轻量通道——不写 design / checklist 直接动手,但先指引 AI 查 CodeStable 知识库再开工。触发:用户说"快速模式"、"fastforward"、"别那么多步骤"、"直接开干",且需求小到不值得走 design 流程。

liuzhengdongfortest/cs-feat-impl

feature 流程阶段 2——按 {slug}-checklist.yaml 里 design 切好的 paradigm 维度 steps 推进,每步具体改哪个文件由 implement 自决,写完用统一格式汇报。触发:用户说"方案确认了开始实现"、"按方案写代码"、"开工"。前提是 design 已 approved 且有 checklist。遇到方案外情况要回方案谈不要硬冲。

liuzhengdongfortest/cs-guide

写或更新对外指南文档——开发者指南(dev-guide)和用户指南(user-guide),产物在项目 docs/ 目录。任务导向(怎么用 X 做 Y),与 libdoc 的零件参考不同。触发:用户说"写文档"、"开发者指南"、"用户指南",或 feature-acceptance 收尾时推送。

liuzhengdongfortest/cs-issue

修 bug 的子流程入口,把"发现问题"走到验证修复闭环,留下 report / analysis / fix-note 三份文件。触发:用户说"修 bug"、"有个问题"、"修复 XX"。只做路由,根据已有产物走 report / analyze / fix。简单问题走快速通道。

liuzhengdongfortest/cs-issue-analyze

issue 流程阶段 2——读 report + 读代码定位根因、评估风险,给用户 2-3 个修复方案让 TA 拍板。这一步不改代码。触发:用户说"分析这个 bug"、"找根因"、"定位问题",且已有 {slug}-report.md。

liuzhengdongfortest/cs-issue-fix

issue 流程阶段 3——按已确认根因和方案定点修复、验证、写 {slug}-fix-note.md 落档。两个入口:标准路径从 analyze 来,快速通道从 report 直接来。触发:用户说"开始修 bug"、"按分析修"、"动手改代码"。只动方案声明的文件,不顺手优化。

liuzhengdongfortest/cs-issue-report

issue 流程阶段 1——通过对话把问题落成可复现、可追溯的 {slug}-report.md,并判定走标准路径还是快速通道。只问现象不猜根因。触发:用户说"提个 issue"、"记录这个 bug"、"我发现一个问题"。issue 工作流的起点。

liuzhengdongfortest/cs-learn

把踩过的坑或好做法沉淀成可检索的 learning 文档,两条轨道 pitfall(坑)/ knowledge(默认做法)。触发:用户说"沉淀知识"、"learning"、"把这次经验记下来",或 acceptance / fix 收尾时推送。

liuzhengdongfortest/cs-libdoc

给库的公开表面(组件 / 函数 / 命令)逐条目生成参考文档,带清单追踪,支持单条目和批量。信息源是源码本身(与 guidedoc 任务导向不同)。触发:用户说"写 API 文档"、"组件文档"、"libdoc",或 acceptance 后发现新增公开接口。

liuzhengdongfortest/cs-refactor

代码优化的子流程入口,处理"行为不变、结构变"的工作(结构 / 性能 / 可读性),按 scan → design → apply 分步执行每步人工放行。触发:用户说"优化一下 / 重构 / 重写 / 拆一下 / 性能不行 / 代码太长"且不夹带行为改动。不处理新需求 / bug / 跨模块架构重划。

liuzhengdongfortest/cs-refactor-ff

refactor 流程的超轻量通道——直接识别 1-3 条低风险优化、一次确认、原地改、跑测试自证。触发:用户说"快速重构"、"小重构"、"简单优化下 XX 函数"、"别那么多步骤",且改动在单函数 / 单组件局部、有测试可自证。

liuzhengdongfortest/cs-req

维护 `.codestable/requirements/` 下的能力愿景文档。三种模式 draft / backfill / update。触发:design 阶段起草愿景、acceptance 阶段落档,或用户说"刷新 requirements"、"补一份 req"、"先把愿景写下来"。

Habilidades Relacionadas