SuperAPI AI 工具集

setup-lidessen-skills

智能体与模型

查看项目

更新于 10-16 09:21

技能介绍

用途

setup-lidessen-skills 是 lidessen 技能集合的操作型部署器。lidessen 方法论本身存在于各个独立技能中(harness、design-driven、goal-driven、reframe、evidence-driven 等);本技能负责把这些技能落地到目标项目所需的接线工作:检测宿主工具、写入正确的 harness 文件,并注入跨越多个 lidessen 技能的通用原则。

与 harness 的关系

harness(以及任何通用 harness 技能)教授的是如何思考智能体上下文——可移植的方法论,适用于任何项目,与具体技能集合无关。本技能是 lidessen 专属的操作层,把 harness 式的结构应用到采用 lidessen 集合的项目上。想了解原理请阅读 harness;要执行接线则运行本技能。

边界:做什么与不做什么

做:

  • 通过配置文件是否存在来检测宿主工具(Claude Code / Codex / Cursor / 其他)
  • 在项目 harness 配置中创建或更新一个带分隔标记的「Lidessen」区块
  • 从 references/cross-cutting-principles.md 注入规范的跨领域原则
  • 维护版本标记,使后续 sync / audit 运行能够检测漂移

不做:

  • 教授 lidessen 方法论(各技能自己的 SKILL.md 负责)
  • 复制或安装技能文件(请使用 clone / symlink / 你的包管理器)
  • 修改各技能内容(每个技能是独立的关注点)

工具检测

在任何子命令写入之前,按优先级顺序检测宿主工具:

  1. 项目根目录存在 CLAUDE.md → Claude Code
  2. 项目根目录存在 AGENTS.md → Codex
  3. 存在 .cursor/ 目录 → Cursor
  4. 以上都不存在 → 明确询问用户正在配置哪个工具

检测到的工具决定目标文件:

工具 目标文件
Claude Code CLAUDE.md
Codex AGENTS.md
Cursor .cursor/rules/lidessen.md(缺失时创建)
其他 询问用户写入位置

如果存在多个宿主配置,优先使用用户指定的那个;否则回退到优先级顺序。

分隔区块格式

lidessen 管理的内容位于成对标记之内,以便重跑时能干净替换而不干扰周边内容:

<!-- lidessen-setup:begin v=<N> -->
... lidessen-managed content ...
<!-- lidessen-setup:end -->

不变式:标记之外的内容属于用户,绝不可触碰。标记之内的内容完全归本技能所有,每次同步都会被替换。需要覆盖某条原则的用户应在标记之外进行——通常是在自己的区块中添加一条相反说明,让 CLAUDE.md 的读者一并看到。

子命令

按参数分派:

  • init — 在尚无 lidessen 区块的项目中搭建该区块。参见 commands/init.md。
  • sync — 用当前规范内容替换 lidessen 区块;提升版本号。参见 commands/sync.md。
  • audit — 只读漂移检查;从不写入。参见 commands/audit.md。

如果无参数调用,默认执行 audit——它是安全的只读操作,并能提供足够信息让用户决定是要 init 还是 sync。

主要矛盾(本技能)

依据规范原则——本技能中承载关键决策的是注入什么内容(references/cross-cutting-principles.md 中的规范内容)。工具检测、标记格式、子命令拆分都是次要的;这些出错可在本地修复,但注入错误内容会传播到每一个使用方项目。应以对待公共 API 的严谨态度对待 references/cross-cutting-principles.md。

适用场景

适用于采用 lidessen 技能集合、需要把方法论接入项目 harness 配置的场景,尤其是需要跨多个宿主工具统一注入通用原则、并希望后续能检测配置漂移的项目。

限制

本技能不教授方法论、不安装技能文件、不修改各技能内容。工具检测依赖配置文件是否存在,无法自动识别时需用户明确指定。其余细节(如具体安装命令、收费与平台信息)暂未提供。