mcpField
I
improve-prompt

improve-prompt

github.com/b4r7xAgent 工作流036 次安装12 周前更新
代码仓库

关于 improve-prompt

将粗略需求整理为结构化 AI 编码提示词的 Agent 技能，供需要明确任务描述的编码工作使用。它要求先分析意图、研究项目上下文，再按固定字段生成提示词。

主要功能

  1. 01识别任务类型与输出目标
  2. 02研究项目文件和开发约定
  3. 03按指定字段构建提示词
  4. 04为复杂任务支持 XML 格式

适用场景

  1. 01把简短需求改写为可执行任务
  2. 02编码前查找相关文件和项目规则
  3. 03为代码修改设定验收条件
  4. 04为 Agent 生成结构化提示词

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/b4r7x/agent-skills --skill improve-prompt

安装后在 Claude Code 中输入/improve-prompt确认已加载。

附带文件references/ai-coding-prompt-guide.mdreferences/project-research-playbook.md

详细介绍

改进提示词

将粗略的提示词转换为精确、结构化的 AI 编码提示词，并自动研究项目上下文。

工作流

按顺序执行全部三个阶段。不得跳过任何阶段。

阶段 1 — 明确意图

解读用户的粗略输入。确定：

  • 任务类型：重构 / 实现 / 调试 / 添加功能 / 迁移 / 审查 / 解释
  • 主要语言和框架（根据输入或阶段 2 的研究确定）
  • 预期输出类型：仅代码 / 修改文件 / 架构计划 / 说明

如果粗略提示词中的任务类型不明确，请合理推断，并在生成的提示词的 Task 字段中说明。

阶段 2 — 研究项目上下文

在编写改进后的提示词之前，先研究当前项目。按照 references/project-research-playbook.md 中的步骤执行。

最低限度的必需研究（始终执行）：

cat README.md 2>/dev/null | head -80
cat CLAUDE.md 2>/dev/null | head -60
cat AGENTS.md 2>/dev/null | head -60
cat .github/copilot-instructions.md 2>/dev/null | head -40
cat .cursorrules 2>/dev/null | head -40
cat package.json 2>/dev/null | head -40
find . -maxdepth 2 -type d | grep -v node_modules | grep -v .git | head -25
git log --oneline -8 2>/dev/null

如果任务提到了具体文件或模块，则进行额外研究——使用 grep 和 glob 查找它们。

完整研究指南： references/project-research-playbook.md

阶段 3 — 输出改进后的提示词

结合阶段 1 的意图和阶段 2 的上下文，按照 references/ai-coding-prompt-guide.md 生成结构化提示词。

必需的输出格式：

**Role:** [specific persona matching the project stack]
**Context:** [framework + key libraries + relevant file paths with exact paths]
**Task:** [one precise action-verb sentence]
**Constraints:** [what NOT to do, style rules, size limits]
**Output format:** [code only / with explanation / diff / step-by-step then code]
**Acceptance criteria:** [testable conditions — at least one]
**References:** [exact file paths from the research phase]

将改进后的提示词放在围栏代码块中输出，方便用户复制。

对于面向 Claude、处于 Agent 式上下文中的复杂任务，优先采用 XML 结构，而不是 Markdown 标题——模板见 references/ai-coding-prompt-guide.md。

字段说明和反模式： references/ai-coding-prompt-guide.md

示例

用户输入（粗略）：“修复身份验证”

**阶段 1：**任务 = 调试/修复；根据项目推断可能使用 TypeScript/Node.js；输出 = 修改后的代码

**阶段 2：**研究发现 src/auth/middleware.ts 使用 NestJS + Passport，最近一次 git 提交显示 JWT 验证错误

阶段 3 输出：

**Role:** Senior TypeScript engineer working on a NestJS REST API with Passport and JWT
**Context:** NestJS app, `src/auth/middleware.ts` handles JWT validation using jsonwebtoken v9. TypeScript strict mode enabled. ESM module.
**Task:** Fix the JWT token validation in `src/auth/middleware.ts` — tokens are not being rejected when expired
**Constraints:** Do not change the `AuthMiddleware` class public interface. No new dependencies. Keep existing error format.
**Output format:** Modified `src/auth/middleware.ts` only, with a brief comment on each change
**Acceptance criteria:** Expired tokens return 401 with `{ error: "TOKEN_EXPIRED" }`. Valid tokens still pass through.
**References:** `src/auth/middleware.ts`, `src/auth/auth.module.ts`

评论

支持 Markdown