manifest-dev
一个确保AI代理在动手前先理解问题的验证优先型开发工具。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:manifest-dev。 它的用途是:一个确保AI代理在动手前先理解问题的验证优先型开发工具。 完整的 Skill 内容见:https://321skill.com/skills/manifest-dev/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘/figure-out 为什么用户登录后的会话经常在30分钟后意外失效?’ 它会先扫描你的身份验证和会话管理相关代码,然后可能回来问你:‘你配置的会话存储是Redis,但心跳检测机制似乎与前端Keep-Alive设置不匹配。你确认过前端发送心跳的间隔吗?’ 这引导你发现配置不一致的核心问题。
介绍
manifest-dev 解决的核心问题是:AI代理在未充分理解需求时就自信地编写出错误的代码。这些代码虽然能编译、能通过测试,但解决的是错误的问题。它旨在将‘理解问题’这一关键步骤重新置于开发流程的核心。
其核心技能 /figure-out 扮演一个‘对抗性思考伙伴’的角色。当你提出一个模糊或复杂的问题时,它不会立即开始编码,而是深入你的代码库,主动挖掘信息,并提出关键性质疑,直到双方对‘什么是正确’达成共识。这迫使开发者在构建之前先进行深度思考。
该工具非常适合那些依赖AI代理(如Claude Code、OpenCode等)进行复杂代码生成或重构的开发者,尤其是全栈开发、后端开发和智能体开发者。当面对遗留代码、难以复现的Bug或需要明确复杂需求的场景时,它能有效防止‘方向性错误’。
建议将其作为开发流程的‘守门员’使用。在启动任何自动化编码循环(如/loop、/goal)之前,先用/figure-out厘清问题,再用/define明确验收标准,最后用/do进行独立验证。它作为插件运行,不干扰现有工作流,可单独使用其核心技能。
核心特点
与同类‘spec-first’工具不同,manifest-dev的`/figure-out`强调‘对抗性理解’,会主动挑战你的假设并挖掘代码上下文,而非简单地将你的描述转化为规范。其`/do`命令要求提供独立于AI代理的验证证明,而非相信AI的自我报告,从而真正保证了‘完成’的可信度。
注意事项
不适合用于快速生成简单、明确的代码片段或执行一次性、无需上下文理解的简单任务。
常见问题
manifest-dev 和普通的 /ask 或 /explain 有什么区别?
`/figure-out` 更具对抗性和主动性,它会深入分析你的代码库,提出你未曾想到的关键问题,目标是共同定义问题,而非单纯解释现有代码。
我需要改变现有的开发流程来使用它吗?
不需要。它可以作为独立技能使用(如仅用`/figure-out`),也可以作为插件集成到现有AI开发环境中,与宿主(如Claude Code)的`/loop`等命令协同工作。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/manifest-dev/raw/index.md 读取 manifest-dev 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/manifest-dev/raw/index.md(查看排版版本)