# Naiyue Skill Builder

> >

- **Type:** Skill
- **Install:** `agentstack add skill-tlzmw001-naiyue-skills-naiyue-skill-builder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tlzmw001](https://agentstack.voostack.com/s/tlzmw001)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tlzmw001](https://github.com/tlzmw001)
- **Source:** https://github.com/tlzmw001/naiyue-skills/tree/main/skills/naiyue-skill-builder

## Install

```sh
agentstack add skill-tlzmw001-naiyue-skills-naiyue-skill-builder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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`，并按其中说明运行：

```bash
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` 已引用资源，流程能到达这些资源。
4. 汇报准确的验证命令和关键输出。

如果项目没有构建或测试系统，明确说明这一点，并把 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](https://github.com/tlzmw001)
- **Source:** [tlzmw001/naiyue-skills](https://github.com/tlzmw001/naiyue-skills)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tlzmw001-naiyue-skills-naiyue-skill-builder
- Seller: https://agentstack.voostack.com/s/tlzmw001
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.