Naiyue Skill Builder

Naiyue Skill 构建器

核心约定

把这个 skill 作为本仓库的项目级 skill 构建编排器使用。 它不替代官方 skill-creator，而是负责判断应该走哪个本地流程、读取哪些项目 reference、以及持久化模版和反馈规则。

默认项目状态放在当前 skill 目录：

• assets/registry.yaml：已注册的可复用 skill 类型。
• assets/global-rules.md：适用于所有生成 skill 的反馈沉淀规则。
• references/user-skill-builder.md：把用户思考方式转成个人 thinking skill。
• references/user-thinking-config.md：配置并检查用户思维 skill 的本地路径。
• references/template-extractor.md：从同类 skill 中提炼可复用模版。
• references/skill-writer.md：基于需求、模版和官方规范写新 skill。
• references/feedback-loop.md：把 skill 使用反馈记录到规则中。
• scripts/quick_validate.py：跨宿主的 skill 目录快速校验脚本。
• scripts/user_thinking_config.py：管理首次调用提醒和用户思维 skill 路径。

除非用户明确指定其他位置，新建项目级 skill 时放到当前仓库的 skills//； .agents/skills/ 和 .claude/skills/ 只放指向该目录的发现入口，不维护内容副本。

初始化门禁

每次调用本 skill 时，先加载 references/user-thinking-config.md，并按其中说明运行：

python3 "$SKILL_DIR/scripts/user_thinking_config.py" status

这里的“首次启动”指本 skill 的第一次调用，因为 Agent Skills 没有宿主应用启动钩子。

• 首次调用尚未配置时，先提醒用户选择创建、配置或暂缓用户思维 skill，再进入下方路由。
• 已配置且可用时，后续需要个人判断指导的流程直接读取状态返回的 user_thinking_skill_path。
• 配置路径失效或内容无效时，停止当前 builder 流程并要求重新配置，不要尝试调用或静默忽略缺失的 skill。
• 用户明确暂缓后，可以继续不依赖个人判断指导的流程。

路由

先选择一个主流程，再只加载对应 reference。

| 用户意图 | 加载 | |---|---| | "把我的想法沉淀成 skill", "更新用户 skill", "像我一样思考" | references/user-skill-builder.md | | "这几个 skill 是一类", "抽模版", "新建 skill 类型" | references/template-extractor.md | | "帮我写一个 skill", "创建项目级 skill", "新建 skill" | references/skill-writer.md | | "把这条记下来", "记录这个坑", "加到模版规则里" | references/feedback-loop.md |

当多个流程重叠时：

1. 写新 skill 时，从 references/skill-writer.md 开始；它会根据注册表判断是否需要套用模版。
2. 记录使用反馈时，从 references/feedback-loop.md 开始；不要直接改目标 skill，除非用户另外要求修改。
3. 遇到反复出现的个人判断原则时，从 references/user-skill-builder.md 开始；不要把跨项目思维规则藏进某个任务模版里。

执行规则

写入或修改 skill 前：

1. 读取当前请求和相关本地 reference。
2. 任务涉及写 skill 或分类 skill 时，先查 assets/registry.yaml。
3. 新建 skill 目录时，优先使用官方 skill-creator 初始化；不可用时再手动创建同等必需结构。
4. 保持 SKILL.md 简洁，把细节流程移到 references/。
5. 路径、阈值、文件名和模版参数放在配置区或 assets/，不要散落硬编码在步骤里。
6. 优先复用已有模版和规则，不要先发明新结构。没有强匹配时从头写，并说明等出现第二个同类 skill 后再提炼模版。

确认边界

一般任务连续执行，不需要每步确认，但以下情况要先停下来确认：

• 基于低置信度或只出现一次的观察更新个人 thinking skill。
• 把用户反馈改写成通用规则并追加到 rules.md。
• 来源 skill 之间存在冲突，且更好的实践不明显。
• 在本仓库外创建全局、用户级或非项目级 skill。

验证

任何生成或更新的 skill，都要做以下检查：

1. 对 skill 目录运行当前 skill 自带的 scripts/quick_validate.py；当前宿主提供官方 skill-creator 时，再追加官方校验。
2. 检查没有初始化模板残留。
3. 验证 L1/L2/L3 完整性：

• L1：声明过的文件已经存在。
• L2：内容是真实实现，不是 TODO 或空壳。
• L3：SKILL.md 已引用资源，流程能到达这些资源。

1. 汇报准确的验证命令和关键输出。

如果项目没有构建或测试系统，明确说明这一点，并把 skill 校验、初始化残留检查和 L1/L2/L3 检查作为适用的验证面。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tlzmw001
• Source: tlzmw001/naiyue-skills
• License: MIT

Install and usage instructions live in the source repository linked above.