作者董老师| 整理笔记写于 2026.10.24用自然语言指挥 AI 开发真实软件项目目录Skill 核心理念与原则AI 辅助编程认知使用场景与注意事项Skill 开源资源获取与评估经典 Skill 实践体验自己开发 SkillSkill 与工具集成独立开发实战流程规范文档体系 SDD 与技术文档提示词模板库最佳实践与经验总结1. Skill 核心理念与原则核心循环生成 → 测试 → 修正AI 辅助开发的本质不是一次性生成完美代码而是通过快速迭代逐步逼近目标生成通过 Skill / Prompt 让 AI 产出初始代码或方案测试运行验证 AI 输出检查是否符合预期修正将问题反馈给 AI引导修正方向再次循环要点每轮循环要有明确验收标准每轮修正只聚焦 1-2 个问题不要一次性抛出所有问题。2. AI 辅助编程认知2.1 传统编程 vs AI 辅助编程维度传统编程AI 辅助编程核心技能手写代码能力Prompt 表达 代码审查能力开发流程设计 → 编码 → 测试描述 → 生成 → 审查 → 修正调试方式断点调试、日志排查将错误信息喂给 AI 分析效率瓶颈编码速度AI 理解准确度 人工审查速度关键转变开发者从“代码编写者”转变为“代码审查者”和“方案设计者”。审查能力比编写能力更重要。2.2 模型选择选择模型时考量代码生成质量、上下文窗口大小、响应速度、计费方式、中文理解能力。要点不同任务适合不同模型。复杂架构用推理强的模型简单补全用速度快的模型。建议准备 2-3 个模型交替使用。3. 使用场景与注意事项3.1 适用场景快速原型开发、重复性代码生成CRUD / 表单 / 列表、代码审查与重构、文档自动生成、测试用例编写。3.2 谨慎场景场景风险应对核心业务逻辑AI 不理解业务上下文关键逻辑必须人工审查安全相关代码认证 / 授权 / 加密 / 支付生成后必须做安全审计性能敏感模块AI 倾向生成“能跑”而非最优需人工评估性能方案复杂算法看似正确但有边界问题重点测试边界条件原则对 AI 代码“信任但验证”越靠近生产环境越需要严格审查。4. Skill 开源资源获取与评估4.1 获取优先级优先级来源示例第一官方资源Anthropic 官方 Skills、Vercel 前端 Skill 库第二社区资源Skill 聚合平台、Cursor 规则库、开源 Skill 仓库第三个人 Skillsmattpocock/skills等知名开发者沉淀4.2 第三方 Skill 安全评估安装前必须检查检查项说明来源可信度作者 / 组织是否知名有无社区背书代码审计查看scripts/目录确认无恶意脚本权限范围请求的权限是否超出功能需要数据泄露是否会访问或传输项目敏感信息维护状态是否还在积极维护要点安装前先git clone阅读skill.md和scripts/内容确认安全再全局安装。4.3 Superpowers 增强插件Superpowers 是一套工作方法论 Skills 集成提供经过验证的开发实践。# 推荐安装方式 npx superpowers -zh注意不推荐手动git clone安装不会配置自动触发钩子。5. 经典 Skill 实践体验5.1 常用 Skill 安装# Skill 创建工具引导式创建自定义 Skill npx skills add anthropics/skillsskill-creator -g PDF 文档处理 npx skills add anthropics/skillspdf -g 前端页面设计 npx skills add anthropics/skillsfrontend-design -g注意以上命令基于笔记整理实际安装前请确认命令是否最新。5.2 Skill 核心结构my-skill/ ├── skill.md # [必须] 定义文件用途、触发条件、执行逻辑 ├── scripts/ # [按需] 可执行脚本 ├── templates/ # [按需] 代码/文档模板 └── examples/ # [强烈建议] 使用示例提升输出质量5.3 配置层级层级作用范围存放位置用户级当前用户用户主目录项目级当前项目项目根目录如CLAUDE.md全局所有项目全局配置目录要点通用规范放用户级项目特定规范放项目级。避免过度依赖全局配置。6. 自己开发 Skill6.1 Skill 目录结构skills/ └── my-skill/ ├── skill.md # 何时触发、生成规则、约束 ├── scripts/ # 自动化脚本 ├── templates/ # 代码/文档模板 └── examples/ # 高质量示例2-3 个6.2 skill.md 示例React 组件 Skill--- name: react-component description: 生成符合项目规范的 React 组件 triggers: - 创建新的 React 组件 --- 执行规则 使用函数组件 TypeScript Props 必须定义 interface 样式使用 Tailwind CSS 导出方式统一使用 named export 文件命名 组件PascalCase如 UserProfile.tsx 测试*.test.tsx6.3 四类实用 SkillSkill 类型核心内容React 组件生成组件模板、命名约定、Props 类型定义规范API 端点生成RESTful 规范、参数校验模板、统一错误格式、接口文档生成Git 提交规范Conventional Commits 格式、分支命名、PR 模板、pre-commit 检查代码安全审计OWASP Top 10 检查清单、SQL 注入 / XSS 检查点、敏感信息扫描要点examples/比规则更重要——AI 是“模仿型选手”给它看好的示例比写一堆规则更有效。7. Skill 与工具集成7.1 集成方式方式说明IDE 插件在 VS Code、Cursor 等编辑器中自动触发CLI 工具通过命令行调用 SkillHook 机制特定事件文件保存 / 代码提交时自动执行7.2 Hook 配置Hook 是“自动化质量守门员”建议至少配置文件修改后 → 自动 diff 审查提交代码前 → 自动 lint 类型检查新增 API 端点 → 自动检查参数校验7.3 权限模式权限级别说明适用场景只读AI 只能读取不能修改代码审查、架构分析受限写入只能修改指定目录日常功能开发推荐完全写入可修改任何文件项目初始化、大规模重构自动执行可自动运行命令CI/CD、自动化任务7.4 Memory 系统让 AI 记住项目上下文技术栈、架构决策、编码风格、踩过的坑。要点定期清理过时 Memory旧信息会误导 AI 做出过时决策。8. 独立开发实战流程8.1 九步流程步骤动作要点1选择项目一句话描述明确边界2AI 生成 PRD人工审查修改3AI 生成 SPEC确认技术方案可行4创建 CLAUDE.md建立项目上下文5骨架搭建验证可运行空壳但能启动6逐个功能开发每个功能一个 commit7Code Review 测试每模块完成后审查8部署上线端到端验证9复盘总结记录经验沉淀为 Skill8.2 遇到问题四步法先想清楚再问 AI先用/plan模式梳理问题让 AI 知道项目背景告诉 AI 当前状况和已做的决策小步快跑用 task 拆解每次只解决一个问题做完就审查 提交Review → Commit → 下一个要点不要“攒一堆问题一起问 AI”。一次问一个解决一个提交一个效率反而更高。8.3 项目实战案例Mini Mall 商城技术栈Next.js 16 TypeScript SQLite / Prisma 5 Tailwind CSS 4 Cookie Session开发要点/plan模式确定方案 → task 拆解任务 → 配置 Hook 自动检查 → 设置权限模式 → 启用 Memory → 定期/review/security-review→ 多模型切换 → 规范 Git 提交9. 规范文档体系 SDD 与技术文档9.1 PRD 需求文档回答三个核心问题问题说明要做什么功能范围、用户故事、核心需求怎么做技术方案、实现路径做到什么程度验收标准、性能指标9.2 SPEC 技术文档模块内容系统架构整体设计、模块划分、通信方式技术选型前端 / 后端 / 数据库 / 部署方案及理由数据模型实体关系、表结构、字段说明API 接口接口列表、请求 / 响应格式、错误码目录结构项目文件组织规范9.3 质量规范三类缺一不可编程规范命名约定、代码风格、注释要求测试规范单元测试覆盖率、集成测试策略、E2E 范围安全规范输入校验、XSS / SQL 注入防护、敏感数据处理9.4 项目文档结构project/ ├── specs/ │ ├── PRD.md # 产品需求文档 │ ├── SPEC.md # 技术规范文档 │ ├── ARCHITECTURE.md # 架构设计文档 │ └── API.md # API 接口文档 ├── src/ ├── CLAUDE.md # AI 项目上下文文件 └── package.json要点CLAUDE.md是项目级“说明书”告诉 AI 技术栈、规范、约束。每次对话自动读取大幅减少“AI 不了解项目”的问题。10. 提示词模板库10.1 项目初始化模板我要创建一个【项目类型】项目。 项目名称【名称】 简述【一句话描述】 技术栈【前端架构】【后端架构】【数据库】 核心功能MVP 1.【功能1】 2.【功能2】 3.【功能3】 请先创建项目结构和基础配置文件暂不实现具体功能。10.2 功能实现模板请在【指定目录/文件】中实现【功能名称】 具体需求 1.【需求点1】 2.【需求点2】 3.【需求点3】 技术约束 参考【已有文件/模板】的风格 使用【指定技术/库】 请先说明实现计划确认后再开始编码。10.3 代码审查模板请对【文件路径和范围】进行代码审查。 审查重点 安全性输入验证、XSS 防护、SQL 注入 错误处理异常是否被正确捕捉 性能是否有明显问题 代码质量可读性、命名规范、重复代码 请按严重程度分级Critical / Warning / Info给出修复建议。10.4 架构设计模板我需要设计一个【系统/功能】的架构。 业务需求【描述】 性能要求【QPS / 响应时间 / 并发用户数】 技术约束【必须使用的技术 / 限制条件】 请给出 系统架构图文字描述 技术选型建议及理由 数据模型设计 API 接口设计 潜在技术风险和应对方案11. 最佳实践与经验总结11.1 开发前必须集成的 SkillSkill 类型优先级Git 提交规范必须提交后自动检查pre-commit hook必须代码风格检查必须安全审计建议文档生成建议11.2 常见陷阱与规避陷阱规避方法过度依赖 AI不审查直接合并所有 AI 代码必须经过 Review上下文丢失AI 忘记约定善用 CLAUDE.md 和 Memory 系统一次性大需求结果不可控拆解为小任务逐个完成忽略安全配置安全审计 Skill 定期 security-reviewSkill 膨胀装太多导致冲突定期清理只保留真正使用的11.3 不会写提示词怎么办用skill-creator让 AI 引导创建参考社区 Skill模仿结构从examples开始先写期望的输入输出示例迭代优化第一版不需要完美11.4 Skill 迭代与版本管理用 Git 管理 Skill 变更记录调整原因定期回顾输出质量淘汰效果差的 Skill验证有效的 Skill 沉淀为团队共享资源作者董老师| 整理笔记写于 2026.10.24 
长河君 · 2026/10/29 2:11:38 · 阅读 1.2k Skill 技能深度实践
作者董老师| 整理笔记写于 2026.10.24用自然语言指挥 AI 开发真实软件项目目录Skill 核心理念与原则AI 辅助编程认知使用场景与注意事项Skill 开源资源获取与评估经典 Skill 实践体验自己开发 SkillSkill 与工具集成独立开发实战流程规范文档体系 SDD 与技术文档提示词模板库最佳实践与经验总结1. Skill 核心理念与原则核心循环生成 → 测试 → 修正AI 辅助开发的本质不是一次性生成完美代码而是通过快速迭代逐步逼近目标生成通过 Skill / Prompt 让 AI 产出初始代码或方案测试运行验证 AI 输出检查是否符合预期修正将问题反馈给 AI引导修正方向再次循环要点每轮循环要有明确验收标准每轮修正只聚焦 1-2 个问题不要一次性抛出所有问题。2. AI 辅助编程认知2.1 传统编程 vs AI 辅助编程维度传统编程AI 辅助编程核心技能手写代码能力Prompt 表达 代码审查能力开发流程设计 → 编码 → 测试描述 → 生成 → 审查 → 修正调试方式断点调试、日志排查将错误信息喂给 AI 分析效率瓶颈编码速度AI 理解准确度 人工审查速度关键转变开发者从“代码编写者”转变为“代码审查者”和“方案设计者”。审查能力比编写能力更重要。2.2 模型选择选择模型时考量代码生成质量、上下文窗口大小、响应速度、计费方式、中文理解能力。要点不同任务适合不同模型。复杂架构用推理强的模型简单补全用速度快的模型。建议准备 2-3 个模型交替使用。3. 使用场景与注意事项3.1 适用场景快速原型开发、重复性代码生成CRUD / 表单 / 列表、代码审查与重构、文档自动生成、测试用例编写。3.2 谨慎场景场景风险应对核心业务逻辑AI 不理解业务上下文关键逻辑必须人工审查安全相关代码认证 / 授权 / 加密 / 支付生成后必须做安全审计性能敏感模块AI 倾向生成“能跑”而非最优需人工评估性能方案复杂算法看似正确但有边界问题重点测试边界条件原则对 AI 代码“信任但验证”越靠近生产环境越需要严格审查。4. Skill 开源资源获取与评估4.1 获取优先级优先级来源示例第一官方资源Anthropic 官方 Skills、Vercel 前端 Skill 库第二社区资源Skill 聚合平台、Cursor 规则库、开源 Skill 仓库第三个人 Skillsmattpocock/skills等知名开发者沉淀4.2 第三方 Skill 安全评估安装前必须检查检查项说明来源可信度作者 / 组织是否知名有无社区背书代码审计查看scripts/目录确认无恶意脚本权限范围请求的权限是否超出功能需要数据泄露是否会访问或传输项目敏感信息维护状态是否还在积极维护要点安装前先git clone阅读skill.md和scripts/内容确认安全再全局安装。4.3 Superpowers 增强插件Superpowers 是一套工作方法论 Skills 集成提供经过验证的开发实践。# 推荐安装方式 npx superpowers -zh注意不推荐手动git clone安装不会配置自动触发钩子。5. 经典 Skill 实践体验5.1 常用 Skill 安装# Skill 创建工具引导式创建自定义 Skill npx skills add anthropics/skillsskill-creator -g PDF 文档处理 npx skills add anthropics/skillspdf -g 前端页面设计 npx skills add anthropics/skillsfrontend-design -g注意以上命令基于笔记整理实际安装前请确认命令是否最新。5.2 Skill 核心结构my-skill/ ├── skill.md # [必须] 定义文件用途、触发条件、执行逻辑 ├── scripts/ # [按需] 可执行脚本 ├── templates/ # [按需] 代码/文档模板 └── examples/ # [强烈建议] 使用示例提升输出质量5.3 配置层级层级作用范围存放位置用户级当前用户用户主目录项目级当前项目项目根目录如CLAUDE.md全局所有项目全局配置目录要点通用规范放用户级项目特定规范放项目级。避免过度依赖全局配置。6. 自己开发 Skill6.1 Skill 目录结构skills/ └── my-skill/ ├── skill.md # 何时触发、生成规则、约束 ├── scripts/ # 自动化脚本 ├── templates/ # 代码/文档模板 └── examples/ # 高质量示例2-3 个6.2 skill.md 示例React 组件 Skill--- name: react-component description: 生成符合项目规范的 React 组件 triggers: - 创建新的 React 组件 --- 执行规则 使用函数组件 TypeScript Props 必须定义 interface 样式使用 Tailwind CSS 导出方式统一使用 named export 文件命名 组件PascalCase如 UserProfile.tsx 测试*.test.tsx6.3 四类实用 SkillSkill 类型核心内容React 组件生成组件模板、命名约定、Props 类型定义规范API 端点生成RESTful 规范、参数校验模板、统一错误格式、接口文档生成Git 提交规范Conventional Commits 格式、分支命名、PR 模板、pre-commit 检查代码安全审计OWASP Top 10 检查清单、SQL 注入 / XSS 检查点、敏感信息扫描要点examples/比规则更重要——AI 是“模仿型选手”给它看好的示例比写一堆规则更有效。7. Skill 与工具集成7.1 集成方式方式说明IDE 插件在 VS Code、Cursor 等编辑器中自动触发CLI 工具通过命令行调用 SkillHook 机制特定事件文件保存 / 代码提交时自动执行7.2 Hook 配置Hook 是“自动化质量守门员”建议至少配置文件修改后 → 自动 diff 审查提交代码前 → 自动 lint 类型检查新增 API 端点 → 自动检查参数校验7.3 权限模式权限级别说明适用场景只读AI 只能读取不能修改代码审查、架构分析受限写入只能修改指定目录日常功能开发推荐完全写入可修改任何文件项目初始化、大规模重构自动执行可自动运行命令CI/CD、自动化任务7.4 Memory 系统让 AI 记住项目上下文技术栈、架构决策、编码风格、踩过的坑。要点定期清理过时 Memory旧信息会误导 AI 做出过时决策。8. 独立开发实战流程8.1 九步流程步骤动作要点1选择项目一句话描述明确边界2AI 生成 PRD人工审查修改3AI 生成 SPEC确认技术方案可行4创建 CLAUDE.md建立项目上下文5骨架搭建验证可运行空壳但能启动6逐个功能开发每个功能一个 commit7Code Review 测试每模块完成后审查8部署上线端到端验证9复盘总结记录经验沉淀为 Skill8.2 遇到问题四步法先想清楚再问 AI先用/plan模式梳理问题让 AI 知道项目背景告诉 AI 当前状况和已做的决策小步快跑用 task 拆解每次只解决一个问题做完就审查 提交Review → Commit → 下一个要点不要“攒一堆问题一起问 AI”。一次问一个解决一个提交一个效率反而更高。8.3 项目实战案例Mini Mall 商城技术栈Next.js 16 TypeScript SQLite / Prisma 5 Tailwind CSS 4 Cookie Session开发要点/plan模式确定方案 → task 拆解任务 → 配置 Hook 自动检查 → 设置权限模式 → 启用 Memory → 定期/review/security-review→ 多模型切换 → 规范 Git 提交9. 规范文档体系 SDD 与技术文档9.1 PRD 需求文档回答三个核心问题问题说明要做什么功能范围、用户故事、核心需求怎么做技术方案、实现路径做到什么程度验收标准、性能指标9.2 SPEC 技术文档模块内容系统架构整体设计、模块划分、通信方式技术选型前端 / 后端 / 数据库 / 部署方案及理由数据模型实体关系、表结构、字段说明API 接口接口列表、请求 / 响应格式、错误码目录结构项目文件组织规范9.3 质量规范三类缺一不可编程规范命名约定、代码风格、注释要求测试规范单元测试覆盖率、集成测试策略、E2E 范围安全规范输入校验、XSS / SQL 注入防护、敏感数据处理9.4 项目文档结构project/ ├── specs/ │ ├── PRD.md # 产品需求文档 │ ├── SPEC.md # 技术规范文档 │ ├── ARCHITECTURE.md # 架构设计文档 │ └── API.md # API 接口文档 ├── src/ ├── CLAUDE.md # AI 项目上下文文件 └── package.json要点CLAUDE.md是项目级“说明书”告诉 AI 技术栈、规范、约束。每次对话自动读取大幅减少“AI 不了解项目”的问题。10. 提示词模板库10.1 项目初始化模板我要创建一个【项目类型】项目。 项目名称【名称】 简述【一句话描述】 技术栈【前端架构】【后端架构】【数据库】 核心功能MVP 1.【功能1】 2.【功能2】 3.【功能3】 请先创建项目结构和基础配置文件暂不实现具体功能。10.2 功能实现模板请在【指定目录/文件】中实现【功能名称】 具体需求 1.【需求点1】 2.【需求点2】 3.【需求点3】 技术约束 参考【已有文件/模板】的风格 使用【指定技术/库】 请先说明实现计划确认后再开始编码。10.3 代码审查模板请对【文件路径和范围】进行代码审查。 审查重点 安全性输入验证、XSS 防护、SQL 注入 错误处理异常是否被正确捕捉 性能是否有明显问题 代码质量可读性、命名规范、重复代码 请按严重程度分级Critical / Warning / Info给出修复建议。10.4 架构设计模板我需要设计一个【系统/功能】的架构。 业务需求【描述】 性能要求【QPS / 响应时间 / 并发用户数】 技术约束【必须使用的技术 / 限制条件】 请给出 系统架构图文字描述 技术选型建议及理由 数据模型设计 API 接口设计 潜在技术风险和应对方案11. 最佳实践与经验总结11.1 开发前必须集成的 SkillSkill 类型优先级Git 提交规范必须提交后自动检查pre-commit hook必须代码风格检查必须安全审计建议文档生成建议11.2 常见陷阱与规避陷阱规避方法过度依赖 AI不审查直接合并所有 AI 代码必须经过 Review上下文丢失AI 忘记约定善用 CLAUDE.md 和 Memory 系统一次性大需求结果不可控拆解为小任务逐个完成忽略安全配置安全审计 Skill 定期 security-reviewSkill 膨胀装太多导致冲突定期清理只保留真正使用的11.3 不会写提示词怎么办用skill-creator让 AI 引导创建参考社区 Skill模仿结构从examples开始先写期望的输入输出示例迭代优化第一版不需要完美11.4 Skill 迭代与版本管理用 Git 管理 Skill 变更记录调整原因定期回顾输出质量淘汰效果差的 Skill验证有效的 Skill 沉淀为团队共享资源作者董老师| 整理笔记写于 2026.10.24