Expert Coding Harness

生产级 AI Agent 技能集，覆盖代码审查、代码安全审计、TDD、需求工程、实施计划与子代理编排、架构设计、调试、前端开发、原型验证、面试知识追踪与技能创建全流程。

技能清单

技能	描述	触发方式	安装命令
code-review-expert（代码审查专家）	资深工程师视角的结构化代码审查，覆盖 SOLID、安全、性能、边界条件	`/code-review-expert`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/code-review-expert`
code-security-audit（代码安全审计专家）	深度数据流分析 + 五阶段审计协议 + 攻击链分析，WooYun 案例库，支持 9 种语言	`/code-security-audit`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/code-security-audit`
tdd-master（TDD 开发大师）	严格 RED-GREEN-REFACTOR，竖向切片，接口设计优先	`/tdd-master`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/tdd-master`
prd-engineer（需求工程师）	访谈驱动的 PRD 编写 + GitHub Issues 拆解 + 实施计划	`/prd-engineer`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/prd-engineer`
architecture-advisor（架构顾问）	全新系统设计或现有架构优化，输出 Mermaid 架构图	`/architecture-advisor`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/architecture-advisor`
debug-expert（调试专家）	4 阶段根因分析，系统化排查，完成前强制验证	`/debug-expert`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/debug-expert`
skill-smith（技能铸造师）	元技能，指导你创建高质量的 Agent 技能	`/skill-smith`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/skill-smith`
source-reading-analyst（源码阅读分析师）	三模式（问答/导读/改造建议）源码理解技能，输出带 Mermaid 图的结构化分析报告	`/source-reading-analyst`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/source-reading-analyst`
brainstorming（方案设计师）	实施前的结构化头脑风暴，协作对话澄清需求、对比方案、输出经验证的设计文档	`/brainstorming`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/brainstorming`
writing-plans（实施计划编写）	在已批准设计后产出可勾选、TDD 粒度、含路径与命令的实施计划	`/writing-plans`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/writing-plans`
subagent-driven-development（子代理驱动开发）	按书面计划逐任务派发子代理，规格符合性审查通过后做代码质量审查	`/subagent-driven-development`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/subagent-driven-development`
react-best-practices（React 最佳实践专家）	React/Next.js 全场景开发指导，覆盖组件设计、Hooks 规范、状态管理选型、性能优化	`/react-best-practices`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/react-best-practices`
frontend-performance-optimization（前端性能优化专家）	基于性能数据的精准瓶颈定位，覆盖 Web Vitals、加载优化、运行时优化、打包体积优化	`/frontend-performance-optimization`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/frontend-performance-optimization`
frontend-code-review（前端代码审查专家）	前端专项代码审查，支持 React/Vue/Next.js/TypeScript，覆盖功能、性能、安全、可维护性六大维度	`/frontend-code-review`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/frontend-code-review`
ai-agent-security（AI Agent 安全专家）	AI Agent 安全审计，覆盖提示注入、工具滥用、权限越界等威胁	`/ai-agent-security`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/ai-agent-security`
api-design（API 设计专家）	RESTful/GraphQL API 设计规范，覆盖接口设计、版本管理、错误处理	`/api-design`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/api-design`
docs-lookup（文档查询）	通过 Context7 MCP 获取库和框架的实时最新文档，防止 API 幻觉	auto-triggered	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/docs-lookup`
planning-with-files（文件化规划）	Manus 风格三文件规划：`task_plan.md/findings.md/progress.md` + hooks 自动回读与 stop 门禁（适合复杂任务/跨会话）	`/planning-with-files`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/planning-with-files`
interview-knowledge-track（面试知识点追踪）	三阶段面试知识点追踪：知识点拆分（KB-INDEX）、按主题检索（opensource + interview-drill）、经历绑定的架构与面试 Markdown 输出	`/interview-knowledge-track`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/interview-knowledge-track`
llm-wiki-interview（LLM Wiki 面试库）	面试向 LLM Wiki 全流程：Raw 层沉淀研究资料，Wiki 层编译维护实体/概念/索引，支持博客收录与知识库 lint	`/llm-wiki-interview`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/llm-wiki-interview`
prototype（原型验证）	一次性原型驱动设计验证：逻辑/状态模型用终端交互 App，UI 方案用多变体路由切换，答完即删	`/prototype`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/prototype`
handoff（会话交接）	将当前对话压缩为结构化交接文档，供下一个 Agent 会话接续工作	`/handoff`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/handoff`
grill-me（深度追问）	对计划或设计进行不留情面的逐分支追问，每次只问一个问题并给出推荐答案，直至达成共同理解	`/grill-me`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/grill-me`
caveman（极简通信模式）	去掉所有废话和客套，保留完整技术内容，削减约 75% token 用量	`/caveman`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/caveman`
improve-codebase-architecture（代码库架构深化）	发现浅模块并提出深化重构机会，提升可测试性与 AI 可导航性；与 architecture-advisor 互补（一个设计新架构，一个改善现有代码）	`/improve-codebase-architecture`	`npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/improve-codebase-architecture`

Cursor / Claude Code 配置体系

本项目构建了完整的双平台配置体系，克隆仓库即可直接使用：

项目根/
├── .cursor/                    # Cursor 配置（克隆即用）
│   ├── hooks.json              # 15 个 hook 事件配置
│   ├── hooks/                  # Cursor 适配层脚本（调用 scripts/hooks/）
│   ├── rules/                  # 永久注入规则（每次对话自动生效）
│   │   ├── common-*.md         # 通用规则：编码、安全、工作流、Git、测试、Agents、模式、性能
│   │   ├── typescript-*.md     # TypeScript/JavaScript 专项规则
│   │   ├── python-*.md         # Python 专项规则
│   │   └── golang-*.md         # Go 专项规则
│   └── skills/                 # 全部 25 个技能（真实目录，内容与 skills/ 一致）
│
├── hooks/                      # Claude Code 配置（仅配置文件）
│   ├── hooks.json              # Claude Code hooks 配置
│   └── README.md               # 安装说明
│
└── scripts/                    # 所有 hook 逻辑脚本（Cursor 和 Claude Code 共用）
    ├── lib/                    # 工具库（utils、resolve-formatter、shell-split 等）
    └── hooks/                  # 核心 hook 脚本

Rules（永久规则）

alwaysApply: true 的规则在每次对话中自动生效；语言专项规则仅在匹配文件类型时激活：

规则文件	范围	内容
`common-coding-style.md`	全局	不可变性、文件组织、错误处理
`common-security.md`	全局	提交前安全检查、密钥管理
`common-development-workflow.md`	全局	设计→TDD→审查→提交流水线
`common-git-workflow.md`	全局	Conventional Commits、PR 流程
`common-testing.md`	全局	80% 覆盖率、TDD 强制工作流
`common-hooks.md`	全局	Hooks 系统说明
`common-agents.md`	全局	按场景选用技能、并行执行、多视角分析
`common-patterns.md`	全局	仓库模式、API 响应格式
`common-performance.md`	全局	模型选择策略、context 管理
`typescript-*.md`	`*.ts/tsx/js/jsx`	TS 不可变性、Zod 验证、Vitest、hooks、patterns
`python-*.md`	`*.py/pyi`	PEP8、pytest、ruff、bandit、hooks、patterns
`golang-*.md`	`*.go`	gofmt、表驱动测试、gosec、hooks、patterns

Hooks（自动化检查）

Hook	Cursor 事件	Claude Code 事件	功能
`check-secrets`	`beforeSubmitPrompt`	`Stop`	检测 API Key / Token / 私钥
`warn-sensitive-file`	`beforeReadFile`	`PreToolUse Read`	读取 `.env`/`.key`/`.pem` 时警告
`config-protection`	—	`PreToolUse Edit`	阻止修改 eslint/prettier 配置
`post-edit-format`	`afterFileEdit`	`PostToolUse Edit`	自动运行 Prettier/Biome 格式化
`post-edit-typecheck`	`afterFileEdit`	`PostToolUse Edit`	编辑 TS 文件后运行 tsc 类型检查
`check-console-log`	`stop`	`Stop`	检测遗留的 `console.log` 语句
`session-start`	`sessionStart`	`SessionStart`	加载上次会话摘要，检测项目类型
`session-end`	`stop`	`Stop`	保存当前会话摘要到 `~/.claude/`
`pre-compact`	`preCompact`	`PreCompact`	context 压缩前保存状态
`cost-tracker`	`stop`	`Stop`	记录 token 用量和费用
`planning-with-files`	`userPromptSubmit/preToolUse/postToolUse/stop`	—	三文件规划注入/回读/提醒/未完成门禁（跨会话不丢目标）

详细说明见 hooks/README.md。

快速开始

使用 npx skills 安装任意技能：

# 安装代码审查专家
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/code-review-expert

# 安装代码安全审计专家
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/code-security-audit

# 安装 TDD 开发大师
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/tdd-master

# 安装需求工程师
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/prd-engineer

# 安装架构顾问
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/architecture-advisor

# 安装调试专家
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/debug-expert

# 安装技能铸造师
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/skill-smith

# 安装源码阅读分析师
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/source-reading-analyst

# 安装方案设计师
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/brainstorming

# 安装实施计划编写
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/writing-plans

# 安装子代理驱动开发
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/subagent-driven-development

# 安装 React 最佳实践专家
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/react-best-practices

# 安装前端性能优化专家
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/frontend-performance-optimization

# 安装前端代码审查专家
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/frontend-code-review

# 安装 AI Agent 安全专家
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/ai-agent-security

# 安装 API 设计专家
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/api-design

# 安装文档查询
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/docs-lookup

# 安装文件化规划（planning-with-files）
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/planning-with-files

# 安装面试知识点追踪
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/interview-knowledge-track

# 安装 LLM Wiki 面试库
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/llm-wiki-interview

# 安装原型验证
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/prototype

# 安装会话交接
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/handoff

# 安装深度追问
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/grill-me

# 安装极简通信模式
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/caveman

# 安装代码库架构深化
npx skills add ProgrammerAnthony/Expert-Coding-Harness --path skills/improve-codebase-architecture

安装后，在 Agent 终端中使用斜杠命令触发：

/code-review-expert              # 审查当前 git 变更
/code-security-audit             # 深度白盒代码安全审计（五阶段协议）
/tdd-master                      # 启动 TDD 开发流程
/prd-engineer                    # 编写产品需求文档
/architecture-advisor            # 分析或设计系统架构
/debug-expert                    # 系统化调试当前问题
/skill-smith                     # 创建一个新的 Agent 技能
/source-reading-analyst          # 阅读、理解并分析现有源码结构
/brainstorming                   # 实施前进行结构化头脑风暴与方案设计
/writing-plans                   # 根据已批准设计编写可执行实施计划
/subagent-driven-development     # 按实施计划逐任务子代理 + 双阶段审查
/react-best-practices            # React/Next.js 开发指导、代码规范、性能优化
/frontend-performance-optimization  # 前端页面性能诊断与优化方案
/frontend-code-review            # 前端项目代码质量全维度审查
/ai-agent-security               # AI Agent 安全威胁分析与防御
/api-design                      # API 接口设计规范与最佳实践
/planning-with-files             # 复杂任务：创建/维护 task_plan.md、findings.md、progress.md
/interview-knowledge-track       # 面试知识点追踪三阶段流程
/llm-wiki-interview              # LLM Wiki 面试知识库全流程管理
/prototype                       # 快速验证设计（逻辑终端 App / UI 多变体路由）
/handoff                         # 将当前会话压缩为下一个 Agent 的交接文档
/grill-me                        # 对计划进行不留情面的逐分支深度追问
/caveman                         # 开启极简通信模式，削减约 75% token 用量
/improve-codebase-architecture   # 发现浅模块并提出深化重构机会

设计理念

中文优先：所有技能流程、输出模板、错误提示均使用中文，符合中文开发者习惯
铁律约束：每个技能文件 < 500 行，每行都要对得起 token 消耗
渐进加载：重型参考文档放入 references/，按需加载，不浪费上下文
确认门控：关键步骤前必须获得用户确认，不自作主张
防幻觉机制：要求以代码证据为依据，禁止无中生有

技能流水线地图（推荐组合用法）

这部分的目标是把“技能列表”升级为“可交接的流水线”，让你在不同阶段切换技能时更可预测、更少返工。

流水线 1：需求/想法 → 设计 → 计划 → 执行 → 收尾

需求澄清：skills/prd-engineer/（当你需要 PRD、验收标准、Issues 拆解）
方案设计：skills/brainstorming/（先设计并获得批准）
实施计划：skills/writing-plans/（把批准的设计变成可勾选任务）
按计划执行：skills/subagent-driven-development/（逐任务子代理实现 + 双阶段审查）
最终质量门禁：skills/code-review-expert/

流水线 2：问题/错误 → 定位 → 修复 → 验证

系统化定位：skills/debug-expert/（先假设清单 + 最小复现，再改代码）
用测试锁住修复：skills/tdd-master/（先写能复现 bug 的测试）
变更收尾：skills/code-review-expert/（确认没有引入新风险）

流水线 3：安全审计 → 修复计划 → 执行 → 复审

审计（先计划后执行）：skills/code-security-audit/
修复计划：skills/writing-plans/（把漏洞修复拆成可执行步骤）
执行：skills/subagent-driven-development/
复审：skills/code-security-audit/（确认漏洞链路已断）

什么时候该“切换技能”

你在问“做什么/为什么/成功标准是什么”：切到 prd-engineer（需求工程师） 或 brainstorming（方案设计师）
你在问“怎么一步步实现，谁来做也能照着做”：切到 writing-plans（实施计划编写）
你在问“按计划把活干完，并且要审查门禁”：切到 subagent-driven-development（子代理驱动开发）
你在问“这段代码质量/安全/可维护性如何”：切到 code-review-expert（代码审查专家）
你在问“为什么坏了/怎么复现/怎么验证修复”：切到 debug-expert（调试专家）（必要时再接 tdd-master（TDD 开发大师））

致谢

本项目灵感来源于以下优秀开源项目，在此致以诚挚感谢：

planning-with-files — Manus 风格的文件化规划工作流（task_plan.md/findings.md/progress.md）与 Cursor hooks 集成参考
spec-kit — 提供了 Spec-Driven Development（SDD）的方法论、模板与工具链参考
everything-claude-code — 提供了完整的 hooks、rules、skills 配置体系架构的参考思路
Anything-Extract — 提供了 TDD、PRD、架构文档等完整技能体系
superpowers — 提供了头脑风暴、系统调试、TDD 铁律等核心工作流思想
skill-dfyx_code_security_review — 提供了专业的代码安全审计方法论
mattpocock/skills — 提供了 prototype、handoff、grill-me、caveman、improve-codebase-architecture 等核心工程技能的设计思路
oh-my-claudecode — Teams-first 多智能体编排框架，提供了 hooks、skills 与多 Agent 协作模式的参考思路

本项目所有技能内容均为独立的中文原创实现，基于上述项目的思想进行了重新设计与功能增强。

许可证

MIT

Navigation Menu

Repository navigation

About

Repository files navigation

Expert Coding Harness

技能清单

Cursor / Claude Code 配置体系

Rules（永久规则）

Hooks（自动化检查）

快速开始

设计理念

技能流水线地图（推荐组合用法）

流水线 1：需求/想法 → 设计 → 计划 → 执行 → 收尾

流水线 2：问题/错误 → 定位 → 修复 → 验证

流水线 3：安全审计 → 修复计划 → 执行 → 复审

什么时候该“切换技能”

致谢

许可证

About

Releases

Packages

Used by

Contributors

Languages

Name		Name	Last commit message	Last commit date
.cursor		.cursor
hooks		hooks
scripts		scripts
skills		skills
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation

Expert Coding Harness

技能清单

Cursor / Claude Code 配置体系

Rules（永久规则）

Hooks（自动化检查）

快速开始

设计理念

技能流水线地图（推荐组合用法）

流水线 1：需求/想法 → 设计 → 计划 → 执行 → 收尾

流水线 2：问题/错误 → 定位 → 修复 → 验证

流水线 3：安全审计 → 修复计划 → 执行 → 复审

什么时候该“切换技能”

致谢

许可证

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages