development

majiayu000 的头像作者 majiayu000

使用通用语言和框架进行软件开发的指南和代码片段。使用此技能来设置项目、编写干净且可维护的代码、管理依赖项并有效进行调试。

📖 中文导读:使用通用语言和框架进行软件开发的指南和代码片段。使用此技能来设置项目、编写干净且可维护的代码、管理依赖项并有效进行调试。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: development description: Guidance and code snippets for software development using common languages and frameworks. Use this skill to setup projects, write clean and maintainable code, manage dependencies, and debug effectively. license: MIT allowed-tools: - python - bash metadata: category: engineering

Software Development Guide

Overview

This skill provides best practices, code snippets, and workflows for modern software development. Use it whenever you need help writing or organizing code, setting up environments, or debugging.

Key Principles

  • Modular design: Break functionality into small, reusable modules. Use descriptive function and variable names.
  • Version control: Use Git to track changes. Commit early and often with meaningful messages.
  • Documentation: Write docstrings and comments. Include a README.md in your projects.

Python Development

Setting up a project

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Format code with black and check style
pip install black isort flake8
black src/
isort src/
flake8 src/

Creating a CLI application

import argparse


def main():
    parser = argparse.ArgumentParser(description="Example CLI")
    parser.add_argument("input_file", help="Path to input file")
    args = parser.parse_args()

    with open(args.input_file) as f:
        content = f.read()
    print(content)


if __name__ == "__main__":
    main()

Debugging with pdb

import pdb


def divide(a, b):
    pdb.set_trace()
    return a / b

Run your script with python -m pdb script.py to step through execution.

JavaScript/Node.js Development

Initializing a project

npm init -y
npm install express

Creating an Express server

const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.listen(port, () => {
  console.log(`Server listening on port ${port}`);
});

Debugging

Use node --inspect-brk to debug your code with Chrome DevTools. Add breakpoints or use debugger; statements in your script.

Best Practices

  • Write unit tests before implementing features (see the testing skill).
  • Structure code into packages and modules.
  • Use continuous integration (CI) to automatically run tests and linters.
  • Document important APIs in a docs folder or inline with docstrings.

Additional Resources

  • Python Packaging Authority’s packaging guide.
  • Node.js documentation.
  • Atlassian Git tutorials.