FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

forward-aways/deepcode-architect-skill: 拒绝低质量代码!无论模型大小,都能让AI像资深架构师一样先思考、设计、再编码的极简Prompt模版 · GitHub

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

DeepCode Architect Skill(深度编码架构师)

🇨🇳 中文说明 | 🇬🇧 English Version ↓

这是什么?

DeepCode Architect 是一个标准化的 AI 编程技能(Skill),强制 AI 在编写任何业务代码前遵循「分析 → 设计 → 确认 → 实现 → 验证」五步工程闭环。

它不是一个聊天机器人提示词,而是一套可被 IDE 插件解析、可复用、可版本管理的工程行为宪法,有效防止 AI 跳过思考直接生成低质量代码。

核心特性

  • 强制设计先行:未输出设计方案并获得用户确认前,禁止生成任何业务逻辑代码
  • 防御性编程约束:自动识别边界情况、错误处理与复杂度分析,拒绝模糊表述
  • 全平台兼容:原生支持 OpenCode,可手动移植到 Cursor / Windsurf / Trae / GitHub Copilot 等主流 AI IDE
  • 语言无关:指令为英文以确保模型遵循度,但 AI 会根据你的提问语言自动切换回复语言
  • 极简资产:仅一个核心文件,零依赖,即装即用

快速安装

OpenCode(推荐)

将本技能目录(含 SKILL.md)复制到 OpenCode 的技能目录即可全局启用:

# 全局安装(推荐)
git clone https://github.com/forward-aways/deepcode-architect-skill.git \
  ~/.config/opencode/skills/deepcode-architect

或复制到当前项目的 .opencode/skills/ 下,仅对该项目生效。

Cursor / Windsurf

OpenCode Skill 的 YAML Front Matter + Markdown 正文可直接作为项目级规则。将 SKILL.md 中 --- 之后的 Markdown 内容复制到项目根目录的 .cursorrules 或 .windsurfrules:

# 提取 Front Matter 之后的正文
sed '1,/^---$/d' SKILL.md > .cursorrules

Trae

Trae 支持项目级规则文件,按同样方式提取正文后复制到 .traerules 即可生效:

sed '1,/^---$/d' SKILL.md > .traerules

GitHub Copilot

Copilot 不支持 YAML Front Matter,需提取纯 Markdown 正文:

sed '1,/^---$/d' SKILL.md > .github/copilot-instructions.md

其他 Agent 框架

直接将 SKILL.md 中 --- 之后的 Markdown 内容作为 System Prompt 使用即可。

仓库结构

deepcode-architect-skill/
├── SKILL.md          # 唯一事实来源(YAML Front Matter + Markdown Body)
├── README.md         # 本文件
└── LICENSE           # MIT 开源协议

贡献指南

欢迎提交 PR 改进 Skill 指令!请确保修改后的 SKILL.md 仍符合 YAML Front Matter + Markdown 标准格式,并保持英文编写以确保跨模型兼容性。

许可证

本项目基于 MIT License 开源。


DeepCode Architect Skill (English)

What is this?

DeepCode Architect is a standardized AI coding skill that enforces a mandatory five-phase engineering workflow: Analysis → Design → Confirmation → Implementation → Verification.

It is not a chatbot prompt. It is a machine-parseable, reusable, version-controlled behavioral constitution for AI coding assistants, preventing them from skipping architectural thinking and generating low-quality code prematurely.

Key Features

  • Design-First Enforcement: No business logic code is generated until a design proposal is output and explicitly confirmed by the user
  • Defensive Programming Constraints: Automatically identifies edge cases, error handling requirements, and complexity analysis; rejects vague specifications
  • Cross-Platform Compatible: Natively supports OpenCode, and can be manually ported to Cursor, Windsurf, Trae, GitHub Copilot, and other mainstream AI IDEs
  • Language-Agnostic: Instructions are written in English to maximize model adherence, while the AI automatically responds in the same language as your query
  • Minimal Footprint: Single core file, zero dependencies, ready to use out of the box

Quick Install

OpenCode (Recommended)

Copy this skill directory (containing SKILL.md) into OpenCode's skill directory to enable it globally:

# Global install (recommended)
git clone https://github.com/forward-aways/deepcode-architect-skill.git \
  ~/.config/opencode/skills/deepcode-architect

Alternatively, copy it under .opencode/skills/ in your project to scope it to that project only.

Cursor / Windsurf

The YAML Front Matter + Markdown body of the OpenCode Skill can be used directly as a project-level rule. Copy the Markdown content after --- from SKILL.md into .cursorrules or .windsurfrules in the project root:

# Strip the Front Matter and keep the body
sed '1,/^---$/d' SKILL.md > .cursorrules

Trae

Trae supports project-level rules. Extract the body the same way and copy it to .traerules:

sed '1,/^---$/d' SKILL.md > .traerules

GitHub Copilot

Copilot does not support YAML Front Matter. Extract the pure Markdown body:

sed '1,/^---$/d' SKILL.md > .github/copilot-instructions.md

Other Agent Frameworks

Use the Markdown content after the --- delimiter in SKILL.md directly as your System Prompt.

Repository Structure

deepcode-architect-skill/
├── SKILL.md          # Single source of truth (YAML Front Matter + Markdown Body)
├── README.md         # This file
└── LICENSE           # MIT License

Contributing

PRs to improve the skill instructions are welcome! Please ensure modified SKILL.md still conforms to the YAML Front Matter + Markdown standard format and remains in English for cross-model compatibility.

License

This project is open-sourced under the MIT License.

About

拒绝低质量代码!无论模型大小,都能让AI像资深架构师一样先思考、设计、再编码的极简Prompt模版

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors


Back | FazBrowse Home | New Git URL