SuperAPI AI 工具集

llp-create

写作与研究

查看项目

更新于 11-05 17:11

技能介绍

用途

llp-create 用于在一个已经存在的 LLP 文档库中撰写单篇 LLP。它把编号分配、文件命名和元数据脚手架自动化,让作者可以专注于正文内容。

主要能力

  • 重复检查:创建前必须先在 llp/ 中检索 Systems: 和 Related: 头部,若发现主题已被现有 LLP 覆盖,会建议扩展现有文档而非新建。
  • 编号分配:下一个编号取历史已分配最大值加一。顶层为四位数 NNNN;子 LLP 为父编号加点号加三位子序号(无子项时为 000)。扫描范围包括 llp/ 全部递归目录(排除 current/、foundation/、reviews/)以及 git 历史中被删除的文档。编号永不重用、不凭空编造,且父文档必须已存在。
  • 文件命名:遵循 NNNN(.NNN)*-slug.type.md 约定,slug 为小写、非字母数字转连字符、合并重复、控制在约六个词以内;type 为小写并与头部 Type: 一致;标题中包含完整的点分编号。
  • 状态管理:每个新 LLP 一律以 Draft 状态开始。
  • 接入工作集:必须把新文档以相对符号链接接入 llp/current/(必要时先创建目录;在不支持符号链接的检出版本中,可用内容为 ../<file> 的普通文件等效替代)。
  • 子 LLP 建议:当文档是对现有 LLP 的细化、规格说明或计划时,应提议子 LLP 而非新顶层编号,且不允许通过重命名重新挂靠父级。
  • 安全约束:不得覆盖已存在文件,命名冲突时停止并询问;类型选择不明确时不得静默决定,需提议并确认。

使用方式

以 /llp-create <title> 调用;用 /llp-create --under NNNN <title> 创建子 LLP;也可仅输入命令,由技能询问。典型触发场景是在设计讨论过程中或之后说“记录这个决策”或“为这个写一篇 LLP”。

技能内附有参考性配方:获取下一个顶层编号可通过查找 llp 下的数字开头 md 文件并结合 git 历史中被删除文件,提取四位数编号取最大值加一;子编号同理匹配父编号加三位子数字。slug 生成规则与类型线索(提案→rfc、需求→spec、已定选择→decision、步骤→plan、教学→explainer、always/never→principles、操作指南→guide、缺陷→issue、发现→research)也有列出。脚手架章节默认包括 Summary、Motivation、Design、Open questions;Decisions 类型使用 Context/Options/Decision/Consequences,Research 类型使用 Findings/Confidence。

产出

生成一篇带完整元数据头部(Type、Status、Systems、Author、Date,相关时含 Related)的新 Draft LLP,并可提议根据当前对话起草正文,最后向用户确认分配的编号与路径。

适用场景与限制

适用于已有 LLP 文档库的团队,在设计讨论后快速固化决策、规格、计划等文档。若没有可加入的文档库,应转交 llp-adopt;若文档属于基础性或存在争议,应转交 llp-review 并按规模调整。资料未提供收费、平台或其他扩展功能信息。