SuperAPI AI 工具集

plan

智能体与模型

查看项目

更新于 10-16 00:30

技能介绍

用途:plan 技能用于在知识库(KB)中创建、更新或列出计划。它从文本或 Markdown 文件读取计划内容,自动提取标题并生成元数据,将规范化文件写入 ~/.claude/plans/,同时通过 MCP 工具一次性 upsert 到知识库。

主要能力:

  • create:读取指定文件,提取首个 # 标题(无则用文件名),生成 slug(小写、非字母数字转连字符、去重、截断 60 字符),推断计划类型(feature、refactor、migration、infra、tooling、workflow、audit、spike,默认 feature),推断标签(最多 10 个),提取摘要(首个非标题非空段落,截断 500 字符),并提取 story_prefix、estimated_stories、feature_dir 等附加元数据。
  • update:轻量更新已有计划的元数据字段,如 priority、status、prefix、type、tags、title、feature-dir、estimated-stories,至少需提供一个可选参数。
  • list:委托给 /plans 技能并透传参数。

使用方式: /plan create <file_path> [--prefix=X] [--priority=P1-P5] [--type=X] [--feature-dir=X] /plan update <plan_slug> [--priority=X] [--status=X] [--prefix=X] [--type=X] [--tags=a,b,c] /plan list [args]

创建时先通过 ToolSearch 加载 kb_upsert_plan,更新时加载 kb_update_plan,列表或唯一性检查时加载 kb_list_plans。若 MCP 工具不可用,需重启 knowledge-base MCP 服务器后重试;已写入的 Markdown 文件可稍后用 pnpm tsx apps/api/knowledge-base/src/scripts/migrate-plans-to-kb.ts 同步到数据库。

适用场景:需要将计划文档结构化存入知识库、统一管理计划元数据、或从计划生成后续故事(如 /pm-bootstrap-workflow)的工作流。

限制:依赖 MCP 工具与知识库服务;文件必须存在;类型与标签推断基于关键词匹配,可能需手动覆盖;未提供收费、平台或效果相关信息。