[PRIORITY] **[DECISION POINT]**

[PRIORITY][DECISION POINT]【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kitQuestion:[Clear question]Why This Matters:[Architectural consequence][Affects: cost/complexity/timeline/scale]Options:| Option | Pros | Cons | Best For | |--------|------|------|----------| | A | [] | [-] | [Use case] |If Not Specified:[Default rationale]dynamic-questioning.md 的「动态问题模板」进一步按优先级分栏组织输出 markdown Based on your request for [DOMAIN] [FEATURE]: ## CRITICAL (Blocking Decisions) ### 1. **[DECISION POINT]** **Question:** [Clear, specific question] **Why This Matters:** - [Explain architectural consequence] - [Affects: cost / complexity / timeline / scale] **Options:** | Option | Pros | Cons | Best For | |--------|------|------|----------| | A | [Advantage] | [Disadvantage] | [Use case] | | B | [Advantage] | [Disadvantage] | [Use case] | **If Not Specified:** [Default choice rationale] ## HIGH-LEVERAGE (Affects Implementation) ### 2. **[DECISION POINT]** [Same format] ## NICE-TO-HAVE (Edge Cases) ### 3. **[DECISION POINT]** [Same format]核心要点每个问题必须带 Options含权衡与 If Not Specified默认值。前者让用户看清后果后者保证用户即使不回答Agent 也能按合理默认值继续推进不会卡死。3.6 完整示例Instagram 克隆的需求澄清dynamic-questioning.md 提供了一个端到端的生成示例展示从「Build an Instagram clone」到结构化提问的完整过程STEP 1解析领域 社交功能 图片分享、点赞/评论互动、用户主页隐含 Feed、关注、认证规模 可能很高社交应用易爆红。STEP 2决策点分类阻塞性存储策略、认证方式、Feed 类型高杠杆实时通知、数据模型复杂度可延后数据分析、高级搜索、Reels/视频。STEP 3按优先级生成问题P0存储策略、Feed 算法、认证方式P1实时通知WebSocket vs 轮询、媒体处理客户端 vs 服务端优化P2Story/Reels功能蔓延延到 v2、DM/聊天独立子系统延到 v2。**STEP 4格式化输出**中Photo Storage Strategy 一题的完整演示### 1. **Photo Storage Strategy** **Question:** Where will user photos be stored and served? **Why This Matters:** - Affects: Monthly hosting costs, page load speed, CDN complexity - High-volume social apps: 1000 users × 10 photos × 2MB 20GB storage **Options:** | Option | Cost model | Speed | Complexity | Best For | |--------|-----------|-------|------------|----------| | **Cloudinary** | Per-tier subscription | Fast (CDN) | Low | MVP, rapid launch | | **AWS S3 CloudFront** | Pay per GB stored/served | Fast (CDN) | Medium | Production, cost-optimized | | **Supabase Storage** | Free tier usage | Medium | Low | Small scale, simple | | **Local Storage** | Server cost | Slow | Low | Development only | **If Not Specified:** Cloudinary (balanced for MVP)注意其中的量化计算20GB 存储估算——问题之所以有力是因为它把架构后果变成了可计算的数字这正是「问题揭示后果」原则的落地。3.7 迭代提问Iterative Questioning需求澄清不是一次性动作dynamic-questioning.md 定义了三个轮次第一轮3-5 问聚焦阻塞决策不拿到答案不继续第二轮初始实现后随着模式浮现追问例如「这个功能隐含了 [X]边缘情况 [Y] 现在处理还是延后」「我们用了模式 A功能 B 是否沿用同一模式」第三轮优化期功能跑通后追问「性能瓶颈在 [X]现在优化还是可接受」「重构 [Y] 提升可维护性还是原样发布」四、原则化沟通进度、错误、完成三件套除了提问本身SKILL.md 还规定了 Agent 在整个协作周期内的沟通规范统称 PRINCIPLE-BASED基于原则核心信条是「Transparency builds trust透明建立信任」。4.1 进度看板Status Board状态必须可见、可行动统一使用表格 状态图标AgentStatusCurrent TaskProgress[Agent Name]✅⏳❌⚠️[Task description][% or count]图标语义表图标含义用法✅已完成任务成功结束运行中正在执行⏳等待中被阻塞等待依赖❌出错失败需要关注⚠️警告潜在问题不阻塞4.2 错误处理模式Error Response PatternSKILL.md 的原则是「错误是清晰沟通的机会」标准响应路径1. Acknowledge the error 2. Explain what happened (user-friendly) 3. Offer specific solutions with trade-offs 4. Ask user to choose or provide alternative并按错误类别预置了应对策略类别应对策略端口冲突提供替代端口或关闭现有占用依赖缺失自动安装或征求许可构建失败展示具体错误 建议修复错误信息不明确请用户提供截图、控制台输出等细节4.3 完成消息结构Completion Structure任务收尾同样有固定四段结构1. Success confirmation (celebrate briefly) 2. Summary of what was done (concrete) 3. How to verify/test (actionable) 4. Next steps suggestion (proactive)即简短庆祝成功 → 具体总结做了什么 → 给出可操作的验证方式 → 主动建议下一步。4.4 沟通五原则原则实现方式简洁Concise不堆砌无关细节直击要点可视化Visual用 emoji✅⏳❌方便快速扫读具体Specific说「大约 2 分钟」不说「等一会儿」给备选Alternatives卡住时提供多条路径主动Proactive完成后主动建议下一步五、反模式清单AVOIDSKILL.md 明确列出五类必须避免的行为每一类都附带「为什么」反模式为什么有害理解之前就跳向解决方案在错误的问题上浪费时间不问就假设需求产出错误的结果第一版过度工程化推迟价值交付忽略约束产出不可用的方案使用「I think我觉得」式表述不确定就该问而不是猜反模式与动态提问原则是一体两面假设是提问的反面。凡是说「I think」都应改写为一个带权衡的提问。六、在 AG Kit 中的完整调用链brainstorming技能并不是孤立存在的从仓库源码可以还原出它在 AG Kit 运行时中的完整调用链。6.1 与/brainstorm工作流的协作.agents/workflows/brainstorm.md 是触发该技能的斜杠命令其 frontmatter 明确声明了依赖关系--- name: brainstorm description: Structured brainstorming for projects and features. Explores multiple options before implementation. version: 1.0.0 requires_agents: project-planner requires_skills: brainstorming artifact_outputs: discovery-notes, decision-summary ---/brainstorm的行为流程是理解目标问题/用户/约束→ 生成至少 3 个方案各带利弊可考虑非常规解法→ 对比并给出带理由的推荐。其输出格式与 brainstorming 技能的问题模板风格一致✅ Pros / ❌ Cons / Effort且声明了产出物discovery-notes探索笔记与decision-summary决策摘要。6.2 与 project-planner 代理的协作.agents中有四个代理在 skills 字段声明依赖brainstormingproject-planner、product-manager、product-owner另在 .agents/manifest.json 中可见更多引用。以 .agents/agent/project-planner.md 为例--- name: project-planner description: Smart project planning agent. Breaks down user requests into tasks... version: 1.0.0 skills: clean-code, app-builder, plan-writing, brainstorming ---该代理在「PHASE 0: CONTEXT CHECK」中规定请求不清晰时「Ask Socratic questions (Phase 0)」——这正是 brainstorming 技能在规划链路中的落点。在 .agents/ARCHITECTURE.md 的 Quick Reference 中也写明「Plan →project-planner→ brainstorming, plan-writing」。6.3 运行时加载协议从 .agents/rules/core-protocol.md 可知技能的加载是有顺序的Agent 激活 → 检查 frontmatter 的skills:字段 → 读取对应SKILL.md作为索引→ 只读取与请求匹配的章节选择性读取以节省 token。优先级为 P0 工作区规则 P1 代理定义 P2 SKILL.md。此外应用技能前必须声明 Using skill: brainstorming...让用户可验证当前生效的知识。6.4 可执行的验证方式SKILL.md 属于托管组件对它的改动会受到 AG Kit 注册表校验的约束。若想验证brainstorming技能的注册状态与依赖关系可在仓库根目录运行# 校验组件注册表与完整性锁涉及 skills 的 frontmatter、路径与依赖 python .agents/scripts/generate_manifest.py --check python .agents/scripts/dependency_graph.py --check # 校验 AG Kit 自洽性版本、注册表、记忆、链接、引用 python .agents/scripts/validate_kit.py # Antigravity 集成与契约校验 npm run check:agents npm run check:antigravity npm run test:antigravity【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考