用途:通过 markdown 文件管理看板特性,每个特性是一个 .md 文件,由 VS Code kanban-markdown 扩展渲染成看板。
文件格式:文件包含 YAML frontmatter,字段顺序为 id、status、priority、assignee、dueDate、created、modified、completedAt、labels、order,之后接 # 标题与正文。序列化需严格匹配:字符串字段用双引号;assignee、dueDate、completedAt 未设置时用裸 null;labels 为行内数组;order 为双引号字符串。status 取值 backlog、todo、in-progress、review、done;priority 取值 critical、high、medium、low。
目录:默认 {workspace}/.devtool/features/,可通过 VS Code 设置 kanban-markdown.featuresDirectory 修改。进行中的特性位于 {featuresDir}/{id}.md,已完成(done)的位于 {featuresDir}/done/{id}.md。
排序:order 使用 fractional indexing,按字典序排序,字符序列为 0-9、A-Z、a-z(base-62)。空列用 a0,追加时递增末尾字符。拖拽移动由扩展自动计算键,技能只需处理追加新特性。
操作:创建时生成 id(小写标题、过滤字符、截断 50 字符、追加日期),设置时间戳并放在目标列末尾;更新时始终刷新 modified,不改 id 与 created,保持序列化格式;移动时更新 status 与 modified,跨越 done 边界时相应设置或清空 completedAt 并移动文件。
限制:资料仅描述文件格式与操作规则,未提供安装命令、价格或扩展本身的使用细节。