SkillsAdd

zhuxining/harness · Archived

code-principles

触发场景：编写新代码、重构现有代码、代码审查、添加功能、修复bug时。根据目标文件的编程语言类型，参考对应的代码规范原则。支持的语言?

First seen Apr 9, 2026

Installation

$ npx skills add zhuxining/harness --skill code-principles
View on skills.sh ↗ GitHub repository ↗

Summary

触发场景：编写新代码、重构现有代码、代码审查、添加功能、修复bug时。根据目标文件的编程语言类型，参考对应的代码规范原则。支持的语言包括：Python (.py)、Rust (.rs)、TypeScript/JavaScript (.ts/.tsx/.js/.jsx)。框架相关代码决策需基于官方文档验证。

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

code-docs-spec Same source · more installs
zhuxining/harness

软件设计文档规范集合，?

4 installs
obsidian-knowledge Same source
zhuxining/harness

Obsidian CLI 操作 MyObsidian vault 的强制协议。每当用户提到 Obsidian、vault、知识库、笔记、Dail…

3 installs
code-simplifier Same source
zhuxining/harness

Simplifies and refines code for clarity, consistency, and maintainability while preserving all …

2 installs
search-and-fetch Same source
zhuxining/harness 2 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

frontend-design Same topic
anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existi…

866.4K installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-diagnostics Same topic
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs

Also in this package

Other skills from zhuxining/harness.

npx skills add zhuxining/harness
code-docs-spec 4 obsidian-knowledge 3 code-simplifier 2 search-and-fetch 2 news 2 macos-screenshot 2 code-design-docs-spec 1 code-reviewer 1

Browse all from zhuxining/harness

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,231 B
  • docs SUMMARY.md 350 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 3 installs

SKILL.md

Code Principles

本技能提供多语言代码规范指导，帮助编写高质量、符合最佳实践的代码。

使用场景

当执行以下任务时参考对应语言的规范：

  • 编写新代码 - 创建新函数、类、模块时
  • 重构代码 - 改进现有代码结构和质量时
  • 代码审查 - 检查代码是否符合规范时
  • 添加功能 - 在现有代码基础上扩展功能时
  • 修复bug - 修改代码解决问题时

语言规范映射

根据文件扩展名选择对应的规范文件：

文件类型 参考文档 关键原则
.py [py-principles.md](references/py-principles.md) 类型安全、现代语法、不可变性、异常处理
.rs [rust-principles.md](references/rust-principles.md) 所有权安全、零成本抽象、惯用语法、并发安全
.ts, .tsx, .js, .jsx [ts-principles.md](references/ts-principles.md) 类型安全、现代JS/TS、React最佳实践、可访问性

核心原则

训练数据会过时。当对框架用法、API 特性或最佳实践存疑时，优先查阅官方文档而非凭记忆决策。

工作流程

  1. 识别语言 - 根据文件路径确定目标语言
  2. 读取规范 - 使用 Read 工具读取对应的参考文件
  3. 应用原则 - 根据规范确保代码满足类型安全、错误处理、命名规范等要求
  4. 自检 - 完成前检查是否符合该语言的最佳实践

核心检查点

所有语言通用的关注维度：

  • 类型注解/签名完整准确
  • 错误处理适当（捕获具体异常、不忽略错误）
  • 命名清晰，意图明确
  • 函数职责单一，复杂度可控
  • 无明显的性能或安全问题

框架/库特定代码需参考官方文档，详见各语言文件的「不确定时参考」小节。