SuperAPI AI 工具集

claude-authoring

编程与开发

查看项目

更新于 10-16 07:14

技能介绍

用途:这是一套撰写 Claude Code 配置文件的写作方法论,针对 rules、skills、CLAUDE.md、memory 四类材料说明“该写什么、写到哪、怎么写好”。系统结构(层级、位置、加载方式)由 claude-config.md 规则覆盖,本技能专注写作方法。

核心判断:用决策测试决定内容归属——无人调用也必须成立的内容写成 Rule;需要主动应用的方法论写成 Skill;项目架构、命令、关注点地图写成 CLAUDE.md;跨会话稳定的模式写入 Memory。反复被违反的约定应先做规则而非技能;每个任务都会调用的方法论,把核心约束提升为规则,方法论本身保留为技能;项目特定约束放项目本地规则,一次性决定放 CLAUDE.md 或记忆,调试洞见放主题记忆文件。

Rules:含 paths frontmatter 与正文,采用祈使句约束,配合正误示例。一个文件一个关注点,超过 80 行通常说明覆盖过多;仅对特定目录生效时用 paths 与 glob,全局规则省略;命名用 kebab-case,路径限定规则加 layer 前缀。

Skills:frontmatter 必填 name、description、version、date、user-invocable,可选 allowed-tools、context、agent、argument-hint。正文用编号章节,写明范围边界与反模式;典型 200 至 800 行;用 /skill-name 引用其他技能,用相对路径引用规则,全局技能不得引用项目本地文件。

CLAUDE.md:作为项目中枢,写项目摘要、工作方式、架构、命令、配置、关注点地图、规则索引与常见坑;不放详细方法论、需自动加载的约束、会话上下文和完整 API 文档。可用 @path 导入,子目录文件会自动加载,增删规则时同步更新索引。

Memory:MEMORY.md 上限 200 行,按主题用 ## 组织,保持精简并去重;细节放 memory/topic-name.md 按需加载。只记录跨多次交互确认的稳定模式、关键架构决策、用户偏好与反复问题的解法,不记录会话上下文、单次读取的未验证结论与临时信息。

演进与检查:规则超长就拆分或抽成技能,技能过短考虑合并为规则,globs 匹配不到文件就修正或删除,规则冲突就合并。提交前逐项核查关注点、路径、重复内容、交叉引用、frontmatter 字段、行数上限与命名规范。若项目定义了 claude-check-rule-scopes,可用其校验规则路径;其他命令与工具细节资料未提供。