{"id":48675690,"url":"https://github.com/jnMetaCode/ai-coding-guide","last_synced_at":"2026-04-26T10:00:33.363Z","repository":{"id":347283428,"uuid":"1193430229","full_name":"jnMetaCode/ai-coding-guide","owner":"jnMetaCode","description":"AI 编程工具实战指南 — 66 个 Claude Code 技巧 + 9 款工具最佳实践 + 可复制配置模板 | AI Coding Tools Guide with 66 Claude Code tips","archived":false,"fork":false,"pushed_at":"2026-04-01T13:25:46.000Z","size":161,"stargazers_count":20,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T16:26:58.300Z","etag":null,"topics":["ai-coding","ai-programming","ai-tools","aider","best-practices","chinese","claude-code","copilot","cursor","gemini-cli","prompt-engineering","vibe-coding","windsurf"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jnMetaCode.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-27T08:04:23.000Z","updated_at":"2026-04-04T08:00:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jnMetaCode/ai-coding-guide","commit_stats":null,"previous_names":["jnmetacode/ai-coding-guide"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jnMetaCode/ai-coding-guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnMetaCode%2Fai-coding-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnMetaCode%2Fai-coding-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnMetaCode%2Fai-coding-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnMetaCode%2Fai-coding-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jnMetaCode","download_url":"https://codeload.github.com/jnMetaCode/ai-coding-guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jnMetaCode%2Fai-coding-guide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32292958,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-coding","ai-programming","ai-tools","aider","best-practices","chinese","claude-code","copilot","cursor","gemini-cli","prompt-engineering","vibe-coding","windsurf"],"created_at":"2026-04-10T15:00:20.022Z","updated_at":"2026-04-26T10:00:33.354Z","avatar_url":"https://github.com/jnMetaCode.png","language":null,"readme":"# AI Coding Tools — The Practical Guide\n\n\u003e **Hands-on best practices for 9 AI coding tools** — No hype, just what works. Prompt techniques, workflow design, multi-tool orchestration, and copy-paste configs to maximize your AI-assisted development.\n\n[简体中文](./README.md) | **English**\n\n[![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/ai-coding-guide?style=social)](https://github.com/jnMetaCode/ai-coding-guide)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\u003cstrong\u003e9 Tools\u003c/strong\u003e\u003cbr/\u003eFull coverage\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cstrong\u003e66 Tips\u003c/strong\u003e\u003cbr/\u003eClaude Code deep-dive\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cstrong\u003e7 Methodologies\u003c/strong\u003e\u003cbr/\u003ePrompting / Debug / Test\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cstrong\u003eCopy-paste Configs\u003c/strong\u003e\u003cbr/\u003eReady to use\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Getting Started\n\n**Start with the [📋 Cheatsheet](cheatsheet.en.md)** — all 9 tools on one page: type, context window, config files, core commands. Know what to pick, how to set it up, how to use it.\n\n**Pick a path based on your profile:**\n\n| You are... | Recommended reading order |\n|------------|---------------------------|\n| Total newcomer to AI coding | [Cheatsheet](cheatsheet.en.md) → [Copilot](copilot/) (free tier) or [Cursor](cursor/) (free tier) → [Prompt Engineering](common/prompting.en.md) |\n| Frontend / daily coding | [Cursor](cursor/) → [Prompt Engineering](common/prompting.en.md) → [Scenarios](workflows/scenarios.en.md) |\n| Backend / refactoring / big projects | [Claude Code](claude-code/) → [Task Decomposition](common/task-decomposition.en.md) → [Scenarios](workflows/scenarios.en.md) |\n| Migrating from Copilot | [Copilot](copilot/) → [Claude Code](claude-code/) (compare) → [Tool Selection](workflows/tool-selection.en.md) |\n| Cost-conscious / solo dev | [Cheatsheet](cheatsheet.en.md) → [Gemini CLI](gemini-cli/) or [Aider](aider/) + local models |\n| Team / high-quality delivery | [Kiro](kiro/) → [Code Review](common/code-review.en.md) → [Testing](common/testing.en.md) |\n\n**Already using AI tools?** Jump to: [Cheatsheet](cheatsheet.en.md) · [Advanced Tips](#9-tool-guides) · [Real-World Workflows](#real-world-workflows) · [Ecosystem](#ecosystem)\n\n---\n\n## 9 Tool Guides\n\n| Tool | Type | Highlights |\n|------|------|-----------|\n| [**Claude Code**](claude-code/README.en.md) | CLI Agent | 66 tips, Agent + Skill + Hook workflows |\n| [**Cursor**](cursor/README.en.md) | IDE | .cursorrules config, Composer Agent mode |\n| [**GitHub Copilot**](copilot/README.en.md) | IDE Plugin | Inline completion + Agent mode + custom instructions |\n| [**OpenClaw**](openclaw/README.en.md) | AI Agent Framework | 338k Stars, multi-platform + Skills + Cron automation |\n| [Windsurf](windsurf/README.en.md) | IDE | Cascade Agent, automatic context |\n| [Gemini CLI](gemini-cli/README.en.md) | CLI | By Google, large codebase analysis |\n| [Kiro](kiro/README.en.md) | IDE | By AWS, spec-driven development |\n| [Aider](aider/README.en.md) | CLI | Git-native, supports almost any LLM |\n| [Trae](trae/README.en.md) | IDE | By ByteDance, free Claude/GPT access |\n\n\u003e Every guide follows the same structure: **Core Concepts → Quick Start → Prompt Tips → Advanced Usage → Config Templates**\n\n---\n\n## Universal Methodologies\n\nThese apply regardless of which tool you use:\n\n| Topic | What it solves |\n|-------|---------------|\n| [Prompt Engineering](common/prompting.en.md) | Prompt techniques specific to AI coding — not generic prompt engineering |\n| [Task Decomposition](common/task-decomposition.en.md) | Breaking large tasks into AI-manageable pieces |\n| [Code Review](common/code-review.en.md) | Best practices for AI-assisted code review |\n| [Debugging](common/debugging.en.md) | Systematic debugging methodology with AI |\n| [Context Management](common/context-management.en.md) | Managing the context window to prevent AI from \"getting dumber\" |\n| [Testing Strategy](common/testing.en.md) | Writing tests with AI — approaches and pitfalls |\n| [Security](common/security.en.md) | Security risks in AI-assisted coding and how to mitigate them |\n\n---\n\n## Real-World Workflows\n\nHow real projects run end-to-end, and how different tools play to their strengths.\n\n| Workflow | Description |\n|----------|-------------|\n| [Real-World Scenarios](workflows/scenarios.en.md) | Refactor, collaborative dev, test backfill — 3 end-to-end scripts, copy and adapt |\n| [⚠️ Pitfalls](pitfalls/README.en.md) | Claude Code / Cursor / Copilot — 8 real-world traps each, with Symptom / Cause / Recovery / Prevention |\n| [Claude Code + Cursor](workflows/claude-code-cursor.en.md) | Claude Code for architecture \u0026 complex refactoring, Cursor for daily coding |\n| [Claude Code + Copilot](workflows/claude-code-copilot.en.md) | Claude Code for agentic tasks, Copilot for inline completions |\n| [Tool Selection Guide](workflows/tool-selection.en.md) | Which tool for which scenario — one table to rule them all |\n\n---\n\n## Ecosystem\n\nThese projects work together to cover the full AI-assisted development pipeline:\n\n```\nLearn the tools → Inject methodologies → Load expert roles → Orchestrate roles → Safety guardrails\n(guide)           (superpowers)         (agents)            (orchestrator)      (shellward)\n```\n\n| Project | Purpose | Description |\n|---------|---------|-------------|\n| **This repo** | Learning | Practical guides for 9 AI coding tools |\n| [superpowers-zh](https://github.com/jnMetaCode/superpowers-zh) | Methodology | 20 skills for AI coding tools — TDD, debugging, code review, and more |\n| [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) | Expert Roles | 211 professional roles — turn AI into a security engineer, DBA, PM, etc. |\n| [agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) | Orchestration | YAML-based multi-role collaboration for complex tasks |\n| [shellward](https://github.com/jnMetaCode/shellward) | Safety | Prevent AI agents from running dangerous commands or leaking sensitive data |\n\n\u003e [Full ecosystem setup guide →](ecosystem.en.md)\n\n---\n\n## Why This Guide?\n\nMost AI coding resources fall into two camps: shallow \"getting started\" posts, or single-tool deep dives. This guide fills the gap:\n\n- **Practical over theoretical** — Every tip has been tested in real projects. No \"AI will change everything\" filler.\n- **Cross-tool coverage** — Compare approaches across 9 tools. Know when to use Cursor vs Claude Code vs Copilot.\n- **Multi-tool workflows** — The biggest wins come from combining tools. We show you how.\n- **Copy-paste ready** — Config templates, prompt snippets, and .cursorrules you can drop into your project today.\n- **Prompt engineering for code** — Generic prompt guides don't cover the nuances of AI coding. This one does.\n\n---\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md).\n\nIn short: add tips, fix outdated content, share workflow experiences — Issues and PRs both work.\n\n---\n\n## Acknowledgments\n\nThis guide builds on excellent work from:\n\n- [claude-code-best-practice](https://github.com/shanraisshan/claude-code-best-practice) — Claude Code best practices\n- [awesome-cursorrules](https://github.com/PatrickJS/awesome-cursorrules) — Cursor rules collection\n- [awesome-copilot](https://github.com/github/awesome-copilot) — Official GitHub Copilot resources\n- [gemini-cli-tips](https://github.com/addyosmani/gemini-cli-tips) — Gemini CLI tips\n- [Everything Claude Code](https://github.com/anthropics/everything-claude-code) — Instinct scoring, AgentShield, multi-language rules\n- [BMAD-METHOD](https://github.com/bmadcode/BMAD-METHOD) — Full SDLC, agent roles, multi-platform\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Make AI coding tools actually work for you.**\n\n[Star this repo](https://github.com/jnMetaCode/ai-coding-guide) · [Open an Issue](https://github.com/jnMetaCode/ai-coding-guide/issues) · [Contribute](https://github.com/jnMetaCode/ai-coding-guide/pulls)\n\n\u003c/div\u003e\n","funding_links":[],"categories":["Resources"],"sub_categories":["Code Search \u0026 Understanding"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FjnMetaCode%2Fai-coding-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FjnMetaCode%2Fai-coding-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FjnMetaCode%2Fai-coding-guide/lists"}