# SDD-Implement：简洁剧本 ## 概述 * **目的：** 任务执行工作流程 - 选择任务、计划实施并跟踪活动规范中的进度。 * **范围：** 在关键检查点经过用户批准的单任务执行。 * **条目：** 在规格确定后通过技能系统调用。 ### 流量 > `[x?]`=决策 · `(GATE)`=用户批准 · `→`=序列 · `↻`=循环 · `§`=章节参考 - **入口** → LoadConfig → `environment action="get-config"sections=["autonomy","git"]` → 合并配置 - [无人值守？] → 跳过用户门 - 任务选择→[选择模式？] - [交互式？] → 选择任务 - [推荐？] → `任务操作=“准备”` → 显示推荐 - [浏览？]→`任务操作=“查询”`→（GATE：任务选择） - 输入调度 → [输入？] - [验证？] → §验证工作流程 - [任务？] → 深入探究 - `任务操作=“准备”` → ExtractContext - 计划草案→（GATE：批准计划） - [已批准] → PreImpl - [更改] → ↻ 返回 DraftPlan - [推迟] → **退出** - PreImpl → LSP 分析 → 探索子代理 - `task action="update-status" status="in_progress"` → **实施** - PostImpl → `任务操作=“完成”` → 日志（自动） - [成功？] → SurfaceNext → `task action="prepare"` → ShowNextTask → (GATE: 继续？) - [是] → ↻ 返回 SelectTask - [else] → **退出** - [被阻止？] → HandleBlocker → `task action="block"` → (GATE: 替代方案) - [add-dep?] → `任务操作=“add-dependency”` - [添加要求？] → `任务操作=“添加要求”` - [解决] → ↻ 回到**实施** - [跳过] → SurfaceNext - [批量执行？] → §BatchExecution（代理根据任务特征决定） §VerifyWorkflow→参见references/verification.md §批量执行流程： - **条目** → `任务操作=“准备批次”` → 识别合格 - [冲突？] → 排除冲突 - `任务操作=“start-batch”` → SpawnSubagents - 对于每个子代理 → 任务（通用，run_in_background=true） - TaskOutput(block=true) → 收集结果 - `任务操作=“完整批次”` → AggregateResults - [失败？] → HandlePartialFailure - [更多批次？] → ↻ 返回准备批次 - [else] → **退出** > 流符号：参见 [dev_docs/flow-notation.md]() ** ** ## MCP 工具此技能仅与 Foundry MCP 服务器（“foundry-mcp”）交互。工具使用 router+action 模式：`mcp__plugin_foundry_foundry-mcp__` 和 `action=""`。路由器|关键行动 ---|--- `任务` | `prepare`、`query`、`info`、`start`、`complete`、`update-status`、`block`、`unblock`、`add-dependency`、`add-requirement`、`session`、`session-step`、`session-events`、`fix-verification-types`、`gate-waiver`、`prepare-batch`、`start-batch`、`complete-batch`、 `重置批次` `研究` | `节点状态`、`节点执行`、`节点记录`、`节点发现` `日记` | “添加”、“列表” `生命周期` | “激活”、“移动”、“完成” `规格` | “查找”、“列表” `日记` | “添加”、“列表” `环境` | `获取配置` **关键规则：** * 代理从不直接调用 CLI * 留在存储库根目录内，避免链接 shell 命令 * 切勿在 MCP 助手之外读取原始规范 JSON ** ** ## 自主驱动执行执行行为由“foundry-mcp.toml”中配置的**自主状态**驱动，而不是由命令标志驱动。姿势决定了技能如何与用户交互并做出决策。 **配置加载：** 入口处调用环境工具读取配置。返回“autonomy”（姿势、安全性、会话默认值）和“git”（提交节奏、auto_push）部分。如果不存在自主配置，则默认为具有严格门的监督状态。 ### 姿势到行为映射姿势|用户提示|任务选择|计划批准 |继续门 ---|---|---|---|--- `无人值守` |已跳过 |自动（推荐）|自动（使用生成的计划）|自动继续 “监督”（默认）|向用户提问 |用户选择|用户批准 |用户确认 `调试` |向用户提问 |用户选择|用户批准 |用户确认 ### 会话默认值控制限制限制源自“autonomy.session_defaults”而不是硬编码值：设置|效果|默认 ---|---|--- `每个会话的最大任务数` |检查点暂停前的任务计数 | 100 `最大连续错误数` |暂停前的错误阈值 | 3 `阶段完成时停止` |在阶段边界处暂停 |假的 `自动重试保真度门` |自动重试失败的保真度审核 |假的 `max_fidelity_review_cycles_per_phase` |保真度重试循环上限 | 3 ### 代理驱动的委派和并行性使用您的最佳判断来判断是否将任务委派给子代理以及是否并行化。考虑： * **任务复杂性**：简单的单文件任务可以内联运行。复杂的多文件任务受益于委派（新上下文）。 * **批处理特性** ：没有文件冲突的独立任务可以并行运行。具有共享文件或顺序依赖关系的任务应串行运行。 * **上下文压力**：当上下文使用率很高时，委托给子代理会保留主要上下文。 * **模型选择** ：使用适合任务复杂性的最小模型（俳句用于简单，十四行诗用于中等，作品用于复杂）。批处理 MCP 操作（“prepare-batch”、“start-batch”、“complete-batch”、“reset-batch”）是可用的工具 - 当任务特征允许时使用它们。 > 批量执行详细信息：[references/parallel-mode.md]() 子代理模式： [references/subagent-patterns.md]() ### 无人看管的姿势行为当“autonomy.posture.profile”为“无人值守”时，该技能将在没有用户提示的情况下连续执行任务。 **关键行为：** * 通过 `task action="prepare"` 自动选择推荐任务 * 跳过计划审批关卡（使用生成的计划） * 任务完成后自动继续 * 暂停于：上下文 >= 85%、连续错误阈值、阻塞任务、任务限制 **会话跟踪：** 使用规范的“任务操作=“会话””命令：“开始”、“状态”、“暂停”、“恢复”、“结束”。通过 `task action="session-step"` 使用以下命令进行步骤编排：`next`、`report`、`replay`、`heartbeat`。 > 完整文档：[references/autonomous-mode.md]() 会话管理： [references/session-management.md]() ** ** ## 关键：全球要求 ### 配置加载（切勿跳过） **进入时，在执行任何其他操作之前立即调用环境工具：** mcp__plugin_foundry_foundry-mcp__environment action="get-config"sections='["autonomy","git"]' 这将返回： *“自主”部分：姿势配置文件、安全设置（角色、锁定旁路、门豁免）、会话默认值（任务限制、错误阈值、保真度周期） * `git` 部分：`commit_cadence`、`auto_push` **不存在自主配置时的默认值：**姿势配置文件= null（监督行为），角色=“维护者”，gate_policy =“严格”，安全限制（100个任务，3个错误，3个保真周期）。 **为什么强制：** 如果没有此调用，技能就无法确定用户交互门和会话限制的正确姿势。 ### 规格阅读规则（切勿违反）该技能**仅**通过 MCP 工具与规范交互： * `mcp__plugin_foundry_foundry-mcp__task 操作 =“准备”` *`mcp__plugin_foundry_foundry-mcp__task操作=“信息”` * `mcp__plugin_foundry_foundry-mcp__spec 操作 =“查找”` * `mcp__plugin_foundry_foundry-mcp__task 操作 =“查询”` 禁止直接 JSON 访问（`Read()`、`cat`、`jq`、`grep` 等）。 ### 用户交互要求 **使用“AskUserQuestion”控制关键决策（当状态为“监督”或“调试”时）：** * 规格选择（当有多个可用时） * 任务选择（推荐与替代） * 计划批准（实施前） * 阻塞处理（替代任务或解决） * 完成验证（用于验证任务） * **任务完成后继续**（当上下文 < 85% 且仍有更多任务时） **当姿势为`无人值守`时：** 跳过以上所有门。该技能会自动选择推荐的任务、使用生成的计划并自动继续。请参阅 [references/autonomous-mode.md]()。 **反模式：** 切勿使用基于文本的编号列表。始终使用“AskUserQuestion”进行结构化选择（在监督/调试状态下）。 ### 反递归规则（永不违反）此技能绝不能调用自身或“技能（铸造厂实现）”。唯一有效的调用者是： * 技能系统（切入点） * 直接用户调用如果您发现自己要从此技能中调用“Skill(foundry-implement)”，请**停止**并继续执行工作流程。该技能处理完整的任务生命周期 - 无需重新调用它。 > 有关详细的上下文收集模式，请参阅 `references/context-gathering.md` 对于代理委托模式（何时使用 Foundry-spec），请参阅 `references/agent-delegation.md` ** ** ## 任务工作流程在用户明确批准的情况下一次执行一项任务。 **假设：** 活动规范已被识别（通过技能自动发现或在调用期间传递）。 ### 选择任务 * **推荐路径** : `mcp__plugin_foundry_foundry-mcp__task action="prepare"` -> 表面任务 ID、文件、复杂性、拦截器 * **浏览路径** ：使用 `mcp__plugin_foundry_foundry-mcp__task action="query"` -> 通过 `AskUserQuestion` 显示候选名单 ### 任务类型调度选择任务后，检查其类型以确定工作流程路径。 **从 `task action="prepare"` 响应或通过 `mcp__plugin_foundry_foundry-mcp__task action="info"` 检查任务类型**：任务类型 |工作流程路径 ---|--- `类型：“验证”` |转到**验证任务工作流程** `类型：“研究”` |转到**研究节点工作流程** `类型：“任务”`（默认）|继续**深入研究和计划批准** **关键：** 验证和研究任务不得经过实施工作流程。它们需要 MCP 工具调用，而不是代码更改。 ### 深入研究和计划批准（仅限实施任务） **注意：** 本节仅适用于“类型：“任务””。验证任务（“类型：“验证””）使用验证任务工作流程。使用目标 `spec_id` 调用 `mcp__plugin_foundry_foundry-mcp__task action="prepare"`。响应包含： * `task_data`：标题、元数据、说明 * `dependency`：阻塞状态（can_start、blocked_by 列表） * `context`：前一个同级、父任务、阶段、同级文件、日志、依赖项将“上下文”视为权威来源。仅当规范明确要求缺少数据时，才回退到 `mcp__plugin_foundry_foundry-mcp__task action="info"`。 > 有关上下文字段详细信息和 JSON 结构，请参阅 `references/context-struct.md` **执行计划草案：** 1. 确认之前在 `context.sibling_files` 中所做的编辑 2. 将可交付成果与“context.parent_task”保持一致 3. 通过“context.phase”指出公开风险 4. 参考 `context.previous_sibling.summary` 以保持连续性 **通过`AskUserQuestion`提出计划：** * 选项：“批准并开始”、“请求更改”、“更多详细信息”、“推迟” ### 子代理指导（实施前探索）在实施之前，请使用 Claude Code 的内置子代理进行高效的代码库探索：场景|子代理 |彻底性 ---|---|--- 查找相关文件/模式 |探索 |中等了解不熟悉的代码区域 |探索 |非常彻底复杂的多档案调查 |通用 |不适用 **调用示例：** 使用 Explore 代理（中等彻底性）查找： - 类似模式的现有实现 - 目标模块的测试文件 - 可能需要更新的相关文档 **子代理探索的好处：** * 防止主要对话中的上下文膨胀 * 小模型尺寸（俳句）对于搜索操作来说更快 * 返回重点结果以进行详细分析 * 保持主要上下文可供实施 > 有关更多子代理模式（包括委派指导），请参阅 `references/subagent-patterns.md` ### LSP依赖分析实施前，使用LSP工具验证依赖关系并预览影响： 1. **验证依赖关系是否存在** : 对任务修改的符号使用 `goToDefinition` 2. **预览影响**：使用“findReferences”来识别所有受影响的文件和调用站点 3. **包含在计划中**：计划批准中的表面 LSP 结果（使用计数、受影响的文件、测试覆盖范围） 4. **后备** ：如果 LSP 对于文件类型不可用，请使用 Explore 代理查找导入和用法 ### 验证范围在实施之前，检查同级验证任务的“context.parent_task.children”以确定适当的验证范围：阶段有验证任务吗？ |实施任务应 ---|--- 是（例如“运行测试”）|推迟正式测试以验证任务。只做基本检查：导入工作，没有语法错误，代码编译没有 |作为实施的一部分运行测试（包括日志中的结果） **检测**：在 `task action="prepare"` 响应的 `context.parent_task.children` 数组中查找具有 `type: "verify"` 的同级。 **基本原理**：当规范作者创建验证任务时，他们打算将测试作为一个单独的跟踪步骤。通过将正式测试执行推迟到验证任务来尊重此结构。 **包含在计划中**：在提交批准的执行计划中说明验证范围（例如，“仅基本验证 - 由 verify-1-1 处理的完整测试”）。 ### 实施移交 **编码前：** mcp__plugin_foundry_foundry-mcp__task action="更新状态"spec_id={spec-id}task_id={task-id}status="in_progress"note="context" **实施期间：** * 遵循执行计划 * 立即记录任何偏差 **实施后：** 使用原子完成操作将任务标记为完成（自动更新状态和日志）： mcp__plugin_foundry_foundry-mcp__task action="complete"spec_id={spec-id}task_id={task-id}completion_note="已完成内容、测试运行、执行验证的摘要" 这在原子上： 1. 将任务状态更新为“已完成” 2.记录完成时间戳 3. 创建日记帐分录 4. 完成时自动记录父节点（阶段） ### 注意（自主捕获） **当您遇到以下情况时，主动添加日记条目**： * 超出当前任务范围的想法/改进 * 发现错误但不能立即采取行动 * 文档空白或令人困惑的行为 mcp__plugin_foundry_foundry-mcp__journal action="添加" spec_id={spec-id} title="[类型] 描述" content="详细信息" **不提示用户。** 静默捕获并继续工作。 ### 表面下一个推荐 **上下文感知：** 当上下文超过 85% 时，`context-monitor` 钩子就会触发。剩余的约 15% 足以以最高质量完成当前任务。请勿因响应此警告而仓促、跳过步骤或降低质量。正常完成当前任务后，不要开始新任务——而是推荐使用 `/clear` 然后使用 `foundry-implement`。 **提出下一个建议：** mcp__plugin_foundry_foundry-mcp__task action =“准备”spec_id = {spec-id} * 总结下一个任务的范围和阻碍因素 * 如果没有完成待完成的工作或规格，请清楚地显示并退出 **强制：延续门** 出现下一个任务后： * **无人值守姿势** ：自动继续下一个任务（无提示）。仍然尊重暂停触发器（上下文 >= 85%、错误阈值、任务限制）。 * **监督/调试姿势** ：用 `AskUserQuestion` 提示用户： * **当上下文 < 85%** 时：询问“继续下一个任务吗？”选项：“是，继续”/“否，退出” * **当上下文 >= 85%**：退出并引导“/clear”，然后“foundry-implement” * **当规范完成时** ：报告完成状态并退出（无需提示）该门可确保受监督的用户控制工作流程速度，而无人值守的执行则在安全限制内自主进行。 > 对于实施后清单，请参阅 `references/checklist.md` ** ** ## 关键：完成要求 ### 永远不要标记完成如果： * 基本检查失败（导入、语法、编译） * 测试失败（仅适用于没有同级验证任务的情况 - 请参阅“验证范围”） * 实施是部分的 * 您遇到未解决的错误 * 您找不到必要的文件或依赖项 * 存在阻止验证的拦截器 ### 如果被阻止或不完整： * 保持任务为“in_progress” * 创建新任务来描述需要解决的问题 * 使用 `mcp__plugin_foundry_foundry-mcp__task action="block"` 的文档拦截器 * 通过“AskUserQuestion”向用户提供替代方案 ### 实施期间的依赖关系发现当您在实施过程中发现缺少依赖项或新需求时，请在不离开任务上下文的情况下记录下来： # 发现这个任务需要先完成另一个任务 mcp__plugin_foundry_foundry-mcp__task action="add-dependency"spec_id={spec-id}task_id={task-id}depends_on={dependency-task-id} # 发现新的验收要求（例如，通过测试） mcp__plugin_foundry_foundry-mcp__task action="add-requirement"spec_id={spec-id}task_id={task-id}requirement="发现的需求的描述" **使用案例：** * **add-dependency** : 任务 A 需要任务 B 的输出 → 添加 B 作为依赖项 * **添加要求** ：测试揭示了边缘情况→添加为验收标准 ### 解决阻塞的任务 mcp__plugin_foundry_foundry-mcp__task action="unblock"spec_id={spec-id}task_id={task-id}resolution="简要说明" ### 完成日记要求 **必须提供期刊内容**描述： * 完成了什么 * 执行验证（范围取决于同级验证任务 - 请参阅“验证范围”）： * **如果阶段有验证任务** ：“基本检查已通过（导入、语法）。完整测试推迟到 {verify-task-id}” * **如果没有验证任务**：“测试运行和结果：{summary}” * 任何与计划的偏差 * 创建/修改的文件 **示例（具有同级验证任务 - 延迟测试）：** mcp__plugin_foundry_foundry-mcp__task action =“complete”spec_id =“my-spec-001”task_id =“task-1-2”completion_note =“已实现phase-add-bulk处理程序。基本验证：导入工作，没有语法错误。完整测试运行推迟到verify-1-1。创建了src/tools/authoring.py处理程序（200行）。” **示例（没有同级验证任务 - 完整测试）：** mcp__plugin_foundry_foundry-mcp__task action =“complete”spec_id =“my-spec-001”task_id =“task-2-3”completion_note =“使用PKCE流程实现了JWT身份验证中间件。所有12个单元测试都通过。手动验证：登录流程在开发环境中工作。创建了src / middleware / auth.ts（180行）和tests / middleware / auth.spec.ts （45 次测试）。” ** ** ## 验证任务工作流程 **条目：** 当任务具有“类型：“验证””时从任务类型调度路由至此处 **关键：** 在继续之前请阅读 [references/verification.md]()。包含强制技能派遣规则。 ** ** ## 研究节点工作流程 **条目：** 当任务具有“类型：“研究””时从任务类型调度路由至此处研究节点使用人工智能驱动的工作流程（聊天、共识、深度思考、构思、深入研究）在实施之前或实施期间调查问题、收集观点或产生想法。 **关键行动：** 1. 检查状态：`research action="node-status"` 2. 执行工作流程：`research action="node-execute"` 3.记录发现：`research action="node-record"` 4. 检索结果：`research action="node-findings"` **阻止模式：** *“困难”：研究必须在家属开始之前完成 * `soft`（默认）：信息性 - 家属可以继续 * `none`：研究永远不会阻碍 **关键：** 在继续之前请阅读 [references/research-workflow.md]()。包含所需的命令语法和记录参数。 ** ** ## 详细参考获取全面的文档，包括： **任务执行：** * 上下文收集最佳实践 → `references/context-gathering.md` * 代理委托模式 → `references/agent-delegation.md` * 深入研究上下文 JSON 结构 → `references/context-struct.md` * 内置子代理模式 → `references/subagent-patterns.md` * 实施后清单 → `references/checklist.md` * 验证任务工作流程 → `references/verification.md` * 研究节点工作流程 → `references/research-workflow.md` * 笔记快速捕获 → `references/note.md` **任务生命周期：** * 任务状态转换 → `references/task-lifecycle.md` * 进度跟踪和验证 → `references/progress-tracking.md` * 日记决策和偏差 → `references/journaling.md` * Spec 文件夹管理 → `references/spec-lifecycle.md` **一般：** * 故障排除 → `references/troubleshooting.md`

铸造机具

包含技能