Agent skill

Code Nest Project Spec

MITAuto-check passedDevelopment

Install Code Nest Project Spec

skills CLI

$ npx skills add xiaou61/Code-Nest --skill code-nest-project-spec -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install xiaou61/Code-Nest code-nest-project-spec --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "code-nest-project-spec" agent skill from https://github.com/xiaou61/Code-Nest/tree/master into .claude/skills/code-nest-project-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-nest-project-spec", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add xiaou61/Code-Nest --skill code-nest-project-spec -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install xiaou61/Code-Nest code-nest-project-spec --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "code-nest-project-spec" agent skill from https://github.com/xiaou61/Code-Nest/tree/master into .agents/skills/code-nest-project-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-nest-project-spec", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add xiaou61/Code-Nest --skill code-nest-project-spec -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install xiaou61/Code-Nest code-nest-project-spec --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "code-nest-project-spec" agent skill from https://github.com/xiaou61/Code-Nest/tree/master into .cursor/skills/code-nest-project-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-nest-project-spec", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add xiaou61/Code-Nest --skill code-nest-project-spec -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install xiaou61/Code-Nest code-nest-project-spec --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "code-nest-project-spec" agent skill from https://github.com/xiaou61/Code-Nest/tree/master into .gemini/skills/code-nest-project-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-nest-project-spec", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install xiaou61/Code-Nest code-nest-project-spec

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add xiaou61/Code-Nest --skill code-nest-project-spec -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "code-nest-project-spec" agent skill from https://github.com/xiaou61/Code-Nest/tree/master into .github/skills/code-nest-project-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-nest-project-spec", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add xiaou61/Code-Nest --skill code-nest-project-spec -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install xiaou61/Code-Nest code-nest-project-spec --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "code-nest-project-spec" agent skill from https://github.com/xiaou61/Code-Nest/tree/master into .opencode/skills/code-nest-project-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "code-nest-project-spec", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: code-nest-project-spec
GitHub stars: 770
Token cost: ~1.3k tokens
SKILL.md length: 352 words
Files: 4,526 (incl. scripts)
Skills in repo: 1
Repo updated: Sep 10, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Works in 12 steps: 目标 → 仓库全景 → 目录速查 → …
Modifying this repository for feature development
SKILL.md covers 1. 目标, 2. 仓库全景, 3. 目录速查 and 4. 模块映射（后端）, plus 10 more sections
Runs Python scripts from its folder; calls npm and mvn

What it does

Code Nest Project Spec is an agent skill from xiaou61/Code-Nest. Code-Nest 多模块全栈项目协作规范与落点导航。Use when modifying this repository for feature development, bug fixing, refactor, API change, SQL migration, or frontend-backend联调 so changes land in the correct module with consistent conventions.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4530 other files, including scripts (for example `.agent/INDEX.md`, `.agent/README.md` and `.agent/history/updates.md`).

It sits in Development, covering SQL and Debugging. It works with SQL, Vue.js and Java. The repository describes itself as: springboot 项目 Code-Nest 程序员一体化社区学习项目. The licence is MIT.

When your agent uses it

Modifying this repository for feature development
Frontend-backend联调 so changes land in the correct module with consistent conventions

Example prompts

“/code-nest-project-spec”

Requirements

Python 3
Docker

Workflow steps

12 steps, taken from the step headings in SKILL.md.

目标
仓库全景
目录速查
模块映射（后端）
路由与鉴权约定（强约束）
返回体与错误码约定（强约束）
后端开发落地步骤
前端开发落地步骤
SQL 与数据变更约定
配置与安全约定
不要手改的内容
改动后验证清单

What it can do on your machine

Read from SKILL.md and the folder at commit f7ed336. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- npm
- mvn
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Code Nest Project Spec loads about 1.3k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 352 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~62
When it runs · the whole SKILL.md, loaded when a task matches: ~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from xiaou61/Code-Nest at commit f7ed336, republished under its MIT licence (© xiaou61). 352 words, ~1,319 tokens.

Download SKILL.mdSave it as .claude/skills/code-nest-project-spec/SKILL.md (or your agent's skills folder). This skill also uses 4525 other files; get the full folder from GitHub.

name: code-nest-project-spec
description: Code-Nest 多模块全栈项目协作规范与落点导航。Use when modifying this repository for feature development, bug fixing, refactor, API change, SQL migration, or frontend-backend联调 so changes land in the correct module with consistent conventions.

Code-Nest 项目规范

1. 目标

在本仓库内进行任何开发时，先用本规范完成三件事：

快速定位改动应该落在哪个模块。
按既有约定实现，避免破坏统一风格。
用最小必要命令验证改动可编译、可运行、可联调。
在我给需求后，你可以调用一些已经有的skill 来帮助你完善这些功能，更好的规范你

2. 仓库全景

后端是 Maven 多模块工程，根 pom.xml 管理版本与子模块。
后端启动入口在 xiaou-application，统一上下文路径是 /api。
前端分为两套：

vue3-admin-front（管理端，默认端口 3000）
vue3-user-front（用户端，默认端口 3001）

每个前端同时支持 Electron 打包，入口在各自 electron/。
数据库脚本在 sql/，采用“基线 + 版本增量”结构。
PRD 与技术文档在 docs/。

3. 目录速查

后端聚合入口：xiaou-application/src/main/java/com/xiaou/CodeNestApplication.java
全局配置：xiaou-application/src/main/resources/application.yml
公共能力：xiaou-common/
用户端 API 封装：vue3-user-front/src/api/
管理端 API 封装：vue3-admin-front/src/api/
用户端路由：vue3-user-front/src/router/index.js
管理端路由：vue3-admin-front/src/router/index.js
SQL 版本脚本：sql/v*/
需求文档：AI-DOCS/PRD/

4. 模块映射（后端）

优先按业务模块改，不要在 xiaou-application 塞业务逻辑。

模块	主要职责
`xiaou-common`	统一返回体、异常处理、鉴权配置、通用工具、公共 Mapper
`xiaou-system`	管理员认证、系统日志、系统管理能力
`xiaou-user`	用户注册登录与用户资料
`xiaou-interview`	面试题库、题单、学习记录与掌握度
`xiaou-community`	社区帖子、评论、标签、分类、用户态社区能力
`xiaou-moment`	动态广场与互动
`xiaou-blog`	博客文章、分类、标签
`xiaou-codepen`	代码作品、模板、收藏/评论/Fork
`xiaou-resume`	在线简历、模板、分析与导出相关
`xiaou-filestorage`	文件上传、存储配置、迁移
`xiaou-notification`	通知中心
`xiaou-chat`	聊天室与实时消息管理
`xiaou-sensitive`	敏感词词库、策略、统计、检测接口实现
`xiaou-knowledge`	知识图谱管理与展示
`xiaou-version`	版本历史
`xiaou-moyu`	摸鱼工具（日历、热榜、Bug 商店等）
`xiaou-points`	积分与抽奖
`xiaou-plan`	计划打卡
`xiaou-mock-interview`	AI 模拟面试流程
`xiaou-flashcard`	闪卡学习
`xiaou-oj`	在线判题、提交、题解、评论、排行
`xiaou-sql-optimizer`	慢 SQL 分析与历史记录
`xiaou-ai`	统一 AI 服务（LangChain4j + LangGraph4j + LlamaIndex）
`xiaou-user-api`	用户跨模块 API 契约（接口与 DTO）
`xiaou-sensitive-api`	敏感词跨模块 API 契约（接口与 DTO）

5. 路由与鉴权约定（强约束）

按 SaTokenConfig 的现有规则组织接口路径：

管理端接口通常走 /auth/** 或 /admin/**
用户端接口通常走 /user/**
公共接口按业务定义（如 /oj/**、/community/**、/version/**）
验证码：/captcha/**（免登录）
Swagger：/v3/api-docs/**、/swagger-ui/**（免登录）

鉴权工具类必须复用：

管理员：StpAdminUtil
用户：StpUserUtil

需要管理员权限的方法优先使用 @RequireAdmin。

6. 返回体与错误码约定（强约束）

后端接口统一返回 Result<T>，定义在：

xiaou-common/src/main/java/com/xiaou/common/core/domain/Result.java
xiaou-common/src/main/java/com/xiaou/common/core/domain/ResultCode.java

关键业务码：

200：成功
701：Token 无效
702：Token 过期
703：权限不足
704：账号禁用

前端拦截器已按上述业务码处理跳转与提示，不要随意改语义。

7. 后端开发落地步骤

先确认业务归属模块，再改对应模块下 controller/service/mapper。
新增接口时，保持现有路径风格（admin/user/pub）。
DTO、枚举、domain 放在当前业务模块，不要塞到 xiaou-application。
公共逻辑先考虑放 xiaou-common，避免复制代码。
跨模块调用先复用 API 契约模块（xiaou-user-api、xiaou-sensitive-api）。
MyBatis XML 一般在 src/main/resources/mapper。
OJ 模块是特例，Mapper XML 在 xiaou-oj/src/main/java/com/xiaou/oj/mapper/。
需要新增模块时，同时更新根 pom.xml 的 <modules> 与 xiaou-application/pom.xml 依赖。

Show full SKILL.md (151 more words)Show less

8. 前端开发落地步骤

先看路由文件定位页面：src/router/index.js。
再看 API 封装：src/api/*.js。
最后改 src/views/** 与 src/components/**。
两端都用 @ 指向 src，按现有别名写法保持一致。
请求统一走 src/utils/request.js，不要重复造 axios 实例。
用户端与管理端 token key 不同：
用户端常用 user_token
管理端常用 token
用户端主要页面在 vue3-user-front/src/views/：
interview、oj、mock-interview
resume、community、moments
blog、codepen、flashcard
points、plan、team、knowledge
管理端主要页面在 vue3-admin-front/src/views/：
user、interview、oj
community、moments、chat
blog、codepen、resume
sensitive、filestorage、logs、system

9. SQL 与数据变更约定

结构变更优先写版本增量脚本到 sql/vX.Y.Z/。
脚本命名使用业务语义，例如 oj_tables.sql、flashcard.sql。
表与字段命名沿用 snake_case。
保持 utf8mb4 与合适索引策略。
涉及线上兼容时，避免直接破坏性 DROP，优先可回滚的增量迁移。
若功能需要初始化数据，提供 INSERT 示例并注明执行顺序。

10. 配置与安全约定

主配置在 xiaou-application/src/main/resources/application*.yml。
私密配置放 application-sec.yml，不要把真实密钥写入公开文档。
AI 相关配置统一走 xiaou.ai.* 配置树，Prompt 规范与运行时设计参考 AI-DOCS/Archive/历史版本/2026-04-20-ai-prompt-governance.md。
监控相关配置与文档：
management.* 在 application.yml
AI-DOCS/Deployment/监控告警/Prometheus监控部署指南.md
docker/monitoring/

11. 不要手改的内容

pom-xml-flattened（由 flatten 插件生成）。
target/、dist/、out/（构建产物）。
node_modules/（依赖目录）。

12. 改动后验证清单

后端最小验证：

bash

mvn -pl xiaou-application -am clean package -DskipTests

后端本地启动：

bash

mvn -pl xiaou-application -am spring-boot:run

管理端本地启动：

bash

cd vue3-admin-front
npm run dev

用户端本地启动：

bash

cd vue3-user-front
npm run dev2

按需补充：

bash

cd vue3-admin-front && npm run lint
cd vue3-user-front && npm run lint

13. 需求分析优先级

收到需求后按以下顺序判断：

这是管理端需求、用户端需求，还是双端需求。
是否需要后端接口变更。
是否需要 SQL 结构变更。
是否影响鉴权、错误码、日志、监控。
是否需要同步 PRD 或部署文档。

14. 文档使用建议

需求细节不明确时，优先查：

README.md（整体能力、启动方式、版本历史）。
AI-DOCS/PRD/*.md（模块级产品规则）。
AI-DOCS/Archive/历史版本/**（专项升级方案）。
AI-DOCS/Archive/coze/*.md（历史 AI 工作流配置归档）。

优先复用现有模块与路径约定，避免“新建平行体系”。

Files

SKILL.md and 4,525 other files (scripts) in the repository root of xiaou61/Code-Nest.

SKILL.md
.agent/INDEX.md
.agent/README.md
.agent/history/updates.md
.agent/memory.md
.agent/rules/always.md
.agent/scripts/generate_core_history.py
.agent/specs/ai-services.md
.agent/specs/architecture.md
.agent/specs/content-community.md
.agent/specs/engagement-and-collab.md
.agent/specs/frontend.md
.agent/specs/learning-and-interview.md
.agent/specs/online-judge-and-tools.md
.agent/specs/operations-sre.md
.agent/specs/system-and-access.md
… and 4,510 more

Open the folder on GitHubat commit f7ed336

Compare with similar skills

Code Nest Project Spec next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Code Nest Project Spec compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Code Nest Project Spec this skillxiaou61/Code-Nest	770	—	~1.3k	Automated safety check: Pass	MIT	27 days ago
Smt E2E Dataflow DebuggingGoogleCloudPlatform/DataflowTemplates	1.3k	—	~1.8k	Automated safety check: Pass	Apache-2.0	today
Relational Query ProcessorFoundationDB/fdb-record-layer	675	—	~1k	Automated safety check: Pass	Apache-2.0	today
Trace And Isolaterohitg00/skillkit	1.5k	—	~1.8k	Automated safety check: Pass	Apache-2.0	4 mo ago
Tidewave Integrationoliver-kriska/claude-elixir-phoenix	564	—	~1.3k	Automated safety check: Pass	MIT	yesterday
Debugging ExperimentsPostHog/posthog-foss	721	—	~5.4k	Automated safety check: Pass	MIT	today

Similar skills

Smt E2E Dataflow Debugging
GoogleCloudPlatform/DataflowTemplates
Debugs logical errors and data discrepancies in Dataflow templates by launching jobs via Terraform and comparing source (e.g.
1.3k GitHub stars~1.8k tokensUpdated today
DevelopmentAuto-check passed
Relational Query Processor
FoundationDB/fdb-record-layer
Specialized skill for working in the fdb-relational-core SQL processing layer — parser, plan generator, and Cascades planner.
675 GitHub stars~1k tokensUpdated today
DatabasesAuto-check passed
Trace And Isolate
rohitg00/skillkit
Applies systematic tracing and isolation techniques to pinpoint exactly where a bug originates in code.
1.5k GitHub stars~1.8k tokensUpdated 4 mo ago
DevelopmentAuto-check passed
Tidewave Integration
oliver-kriska/claude-elixir-phoenix
Tidewave MCP runtime tools — debugging, smoke testing, live state inspection, SQL queries, hex docs.
564 GitHub stars~1.3k tokensUpdated yesterday
DatabasesAuto-check passed
Debugging Experiments
PostHog/posthog-foss
Official
Debug and support PostHog Experiments (A/B tests) for a customer looking at their own results.
721 GitHub stars~5.4k tokensUpdated today
DevelopmentAuto-check passed
Kolo
koloai/kolo
Kolo is a text-based Python debugger that captures every executed function, return value, local variable, HTTP request, and SQL query into greppable trace files.
525 GitHub stars~1.2k tokensUpdated 5 mo ago
DatabasesAuto-check passed

Works with

Questions about Code Nest Project Spec

What does Code Nest Project Spec do?

Code-Nest 多模块全栈项目协作规范与落点导航。Use when modifying this repository for feature development, bug fixing, refactor, API change, SQL migration, or frontend-backend联调 so changes land in the correct module…. Code Nest Project Spec is an agent skill from xiaou61/Code-Nest. Code-Nest 多模块全栈项目协作规范与落点导航。Use when modifying this repository for feature development, bug fixing, refactor, API change, SQL migration, or frontend-backend联调 so changes land in the correct module with consistent conventions.

When should I use Code Nest Project Spec?

Code Nest Project Spec fits situations like: modifying this repository for feature development; frontend-backend联调 so changes land in the correct module with consistent conventions.

How do I install Code Nest Project Spec in Claude Code?

Run `npx skills add xiaou61/Code-Nest --skill code-nest-project-spec -a claude-code`. Or copy the skill folder (the xiaou61/Code-Nest repository) into .claude/skills/code-nest-project-spec in your project. Claude Code loads it when a task matches its description.

How do I install Code Nest Project Spec in Codex?

Run `npx skills add xiaou61/Code-Nest --skill code-nest-project-spec -a codex`. Or copy the skill folder (the xiaou61/Code-Nest repository) into .agents/skills/code-nest-project-spec in your project. Codex loads it when a task matches its description.

Can I use Code Nest Project Spec in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add xiaou61/Code-Nest --skill code-nest-project-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-nest-project-spec, .gemini/skills/code-nest-project-spec, .github/skills/code-nest-project-spec and .opencode/skills/code-nest-project-spec in your project.

What does Code Nest Project Spec need to run?

Going by SKILL.md and its folder, Code Nest Project Spec needs Python for the scripts in its folder and the command-line tools its instructions call (npm and mvn). Our summary lists: Python 3; Docker.

Does Code Nest Project Spec access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Code Nest Project Spec safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Code Nest Project Spec use?

Code Nest Project Spec is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Code Nest Project Spec use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Code Nest Project Spec?

Skills that share tags, products or a category with Code Nest Project Spec: Smt E2E Dataflow Debugging (GoogleCloudPlatform/DataflowTemplates, 1.3k stars), Relational Query Processor (FoundationDB/fdb-record-layer, 675 stars), Trace And Isolate (rohitg00/skillkit, 1.5k stars) and Tidewave Integration (oliver-kriska/claude-elixir-phoenix, 564 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Code Nest Project Spec?

xiaou61 (a GitHub user) maintains it in xiaou61/Code-Nest, which has 770 GitHub stars. The repository was last updated on September 10, 2026.

Source: xiaou61/Code-Nest on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Code Nest Project Spec

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Code-Nest 项目规范

1. 目标

2. 仓库全景

3. 目录速查

4. 模块映射（后端）

5. 路由与鉴权约定（强约束）

6. 返回体与错误码约定（强约束）

7. 后端开发落地步骤

8. 前端开发落地步骤

9. SQL 与数据变更约定

10. 配置与安全约定

11. 不要手改的内容

12. 改动后验证清单

13. 需求分析优先级

14. 文档使用建议

Files

Compare with similar skills

Similar skills

Smt E2E Dataflow Debugging

Relational Query Processor

Trace And Isolate

Tidewave Integration

Debugging Experiments

Kolo

Related

Questions about Code Nest Project Spec