平台工具（流程 E–I）
流程 E 到 I 涵盖更广泛的开发生态系统 — 技术栈决策、代理生成、开发生命周期工具、Git 集成、多代理编排、治理和运维。
快速参考
| 工具 | 描述 | 可用性 |
|---|---|---|
suggest_stack | 根据项目目标和约束推荐最佳技术栈 | 已包含 |
check_versions | 检查框架和工具的已安装版本；推荐更新 | 已包含 |
generate_skill | 从规格或代码库模式生成 Claude 技能 | 已包含 |
skill_search | 跨多个注册表搜索可安装的 Claude 技能 | 已包含 |
skill_install | 从注册表将技能安装到项目的 .claude/skills/ 目录 | 已包含 |
detect_agent | 检测代码库中的 AI 代理能力和行为 | 已包含 |
detect_deprecations | 检测正在使用的已弃用模式、API 或库 | 已包含 |
generate_sub_agent | 为特定任务生成专业子代理配置 | 已包含 |
generate_rules | 从规格生成项目规则和约定 | 已包含 |
generate_teammate_prompt | 为代理团队生成结构化代理提示词 | 已包含 |
suggest_tooling | 建议可改善开发工作流的工具和集成 | 已包含 |
discover_mcps | 发现可用的 MCP 服务器及其能力 | 已包含 |
suggest_mcps | 根据项目需求建议 MCP 服务器 | 已包含 |
suggest_mcp_server | 为当前项目建议合适的 MCP 服务器 | 已包含 |
generate_tests | 从规格生成全面的测试用例和测试场景 | 已包含 |
generate_docs | 从规格自动生成技术文档 | 已包含 |
generate_ci | 为项目生成 GitHub Actions CI 工作流配置 | 已包含 |
generate_planu_ci | 生成 Planu 专用的 GitHub Actions CI 工作流 | 已包含 |
transform_code | 使用 TypeScript 编译器 API 应用确定性代码转换 | 已包含 |
integrate_pm | 将项目管理工具和工作流与 Planu 集成 | 已包含 |
update_registry | 向本地注册表添加自定义框架条目 | 已包含 |
manage_hooks | 为项目配置和管理 Git 钩子 | 已包含 |
start_hooks | 为项目启动文件监视器和钩子引擎 | 已包含 |
stop_hooks | 停止文件监视器和钩子引擎 | 已包含 |
hook_status | 获取钩子引擎的当前状态 | 已包含 |
configure_hooks | 在运行时查看或更新钩子引擎配置 | 已包含 |
manage_git | 管理 Git 操作：分支、提交、推送、PR | 已包含 |
create_pr_from_spec | 从规格创建 GitHub Pull Request | 已包含 |
review_pr | 分析 Pull Request 差异以获取审查结果 | 已包含 |
pr_status | 列出带审查状态和 CI 检查的开放 Pull Request | 已包含 |
create_release | 创建带自动生成发布说明的 GitHub Release | 已包含 |
generate_changelog | 从两个 Git 引用之间的合并 Pull Request 生成变更日志 | 已包含 |
orchestrate | 协调和执行复杂的多步骤工作流 | 已包含 |
orchestrate_runtime | 使用可配置拓扑启动和协调并行代理 | 已包含 |
orchestrate_agents | 为并行或顺序任务执行编排多个 AI 代理 | 已包含 |
agent_swarm_status | 获取编排会话状态：代理进度、任务状态、指标和成本 | 已包含 |
validate_team_results | 在并行执行后验证所有团队成员的综合结果 | 已包含 |
manage_context | 跨规格和项目管理和优化上下文使用 | 已包含 |
context_budget | 查看和管理 AI 辅助开发的上下文词元预算 | 已包含 |
token_intelligence | 高级词元分析：成本跟踪、预算监控、估算准确性、趋势检测和异常警报 | 已包含 |
consult_docs | 无需离开 CLI 即可搜索和查阅项目文档 | 已包含 |
migrate_tech | 规划和执行技术迁移 | 已包含 |
ecosystem_status | 扫描外部生态系统来源，获取与项目技术栈相关的新能力、模式和集成机会 | 已包含 |
generate_infrastructure | 从规格生成基础设施即代码（IaC） | 已包含 |
configure_roles | 为项目启用或禁用基于角色的访问控制（RBAC） | 已包含 |
assign_role | 为用户分配项目或特定规格的角色 | 已包含 |
configure_workers | 配置后台分析工作进程：启用/禁用、设置冷却时间、设置优先级 | 已包含 |
worker_status | 显示后台分析工作进程的状态 | 已包含 |
configure_llm_providers | 为多提供商支持配置 LLM 提供商 | 已包含 |
llm_provider_status | 显示所有已配置 LLM 提供商的状态，包括健康状况和成本跟踪 | 已包含 |
configure_observability | 配置 OpenTelemetry（OTel）追踪和指标 | 已包含 |
manage_plugins | 列出、安装、激活、停用、卸载或获取 Planu 插件信息 | 已包含 |
scaffold_plugin | 生成带清单、入口点、测试和示例的插件项目起始代码 | 已包含 |
token_usage | 查看词元消耗指标、缓存性能和优化节省 | 已包含 |
submit_feedback | 提交错误报告、功能请求或建议 | 已包含 |
triage_feedback | 查看和优先处理按相似度分组的待处理用户反馈 | 已包含 |
resolve_feedback | 将反馈标记为已解决，并链接到处理它的规格和 PR | 已包含 |
registry_search | 在 Planu 规格注册表中搜索可复用规格 | 已包含 |
registry_install | 从 Planu 注册表将规格安装到本地项目 | 已包含 |
configure_oauth | 检查或测试 OAuth 2.1 Bearer 令牌身份验证 | 已包含 |
流程 E — 技术栈与代理
suggest_stack
根据项目目标和约束推荐最佳技术栈。
适用场景： 在项目初期团队在竞争技术之间进行选择时，或在针对项目约束验证技术栈选择时。
提示词："Suggest a stack for a real-time collaborative document editor for project proj_abc123"check_versions
检查框架和工具的已安装版本；推荐更新。
检查内容：
- 当前版本与最新稳定版本的对比
- 已知 CVE 和安全公告
- 已弃用的包
- 主版本差异的破坏性变更警告
提示词："Check dependency versions for project proj_abc123"generate_skill
从规格或代码库模式生成 Claude 技能。
支持的平台： Claude Code（CLAUDE.md 技能）、Cursor（.cursorrules 片段）、Windsurf、Copilot 指令、自定义代理定义。
提示词："Generate a Claude Code skill for the authentication workflow in project proj_abc123"skill_search
跨多个注册表搜索可安装的 Claude 技能。
适用场景： 当你想查找与技术栈或工作流相关的社区维护或 Planu 精选技能时。
提示词："Search for TypeScript skills in the Planu skill registry"skill_install
从注册表将技能安装到项目的 .claude/skills/ 目录。
适用场景： 使用 skill_search 找到技能后，将其添加到项目以便代理自动使用。
提示词："Install the typescript-expert skill into project proj_abc123"detect_agent
检测代码库中的 AI 代理能力和行为。
适用场景： 当你需要生成代理特定的工件（规则文件、技能、记忆文件），并希望 Planu 自动选择正确格式时。
提示词："Detect what AI agent is configured at /workspace/my-app"detect_deprecations
检测正在使用的已弃用模式、API 或库。
适用场景： 在主版本升级之前，或作为季度技术债务审查的一部分。无需网络即可扫描项目源文件。
提示词："Detect deprecated APIs in project proj_abc123"generate_sub_agent
为特定任务生成专业子代理配置。
输出内容： 带有能力、资源归属、交接协议和通信契约的结构化代理定义 — 可直接与 orchestrate_agents 配合使用。
提示词："Generate a sub-agent for the database migration task in spec SPEC-011 for project proj_abc123"generate_rules
从规格生成项目规则和约定 — .cursorrules、CLAUDE.md、Copilot 指令或 Windsurf 规则 — 从项目章程和检测到的模式派生。
提示词："Generate a CLAUDE.md for project proj_abc123"
提示词："Generate .cursorrules for project proj_abc123"generate_teammate_prompt
为代理团队生成结构化代理提示词。
适用场景： 在使用 orchestrate_agents 或 orchestrate_runtime 设置并行代理执行时。每个团队成员获得一个专注的、非重叠的提示词，带有明确的文件归属。
提示词："Generate teammate prompts for specs SPEC-012 through SPEC-015 in project proj_abc123"流程 F — 开发生命周期
suggest_tooling
建议可改善开发工作流的工具和集成。
覆盖范围：
- CI/CD（GitHub Actions、GitLab CI、CircleCI 等）
- 测试（单元、集成、E2E、视觉回归）
- 监控和可观测性（OpenTelemetry、Datadog、Grafana）
- AI 原生工具（LLM 可观测性、语义缓存、提示词管理、护栏）
- 前端性能工具（Lighthouse CI、视觉回归、组件库）
提示词："Suggest tooling for project proj_abc123"discover_mcps
发现可用的 MCP 服务器及其能力。
适用场景： 当你想了解当前环境中配置了哪些 MCP 服务器时。
提示词："What MCP servers are available in my environment?"suggest_mcps
根据项目需求建议 MCP 服务器。
适用场景： 在启动新项目时，希望获得与检测到的技术栈和工作流模式匹配的 MCP 服务器推荐时。
提示词："Suggest MCP servers for project proj_abc123"suggest_mcp_server
为当前项目建议合适的 MCP 服务器。
适用场景： 当你需要针对特定能力缺口的专项推荐时（例如，"我需要一个用于数据库操作的 MCP 服务器"）。
提示词："Suggest an MCP server for managing PostgreSQL for project proj_abc123"generate_tests
从规格的验收标准生成全面的测试用例和测试场景。
输出内容：
- 测试用例名称映射到验收标准的测试计划
- 你项目测试框架中的测试文件框架（vitest、pytest、go test、JUnit 等）
- 每个标准的覆盖率目标
- 外部依赖的模拟策略
提示词："Generate tests for spec SPEC-003 in project proj_abc123"generate_docs
从规格自动生成技术文档 — API 文档、README 章节、架构概述。
提示词："Generate API documentation for spec SPEC-007 in project proj_abc123"
提示词："Generate a README section for the authentication module from spec SPEC-001"generate_ci
为项目生成 GitHub Actions CI 工作流配置。
支持： GitHub Actions、GitLab CI、CircleCI、Jenkins、Azure Pipelines、Bitbucket Pipelines。
提示词："Generate a GitHub Actions CI pipeline for project proj_abc123"generate_planu_ci
生成 Planu 专用的 GitHub Actions CI 工作流，在 CI 流水线中验证规格、检测漂移并强制执行质量门。
提示词："Generate a Planu CI check for my GitHub Actions pipeline in project proj_abc123"transform_code
使用 TypeScript 编译器 API 应用确定性代码转换。
适用场景： 在迁移代码模式（基于类到函数式、回调到 async/await）、重构以匹配规格需求，或在代码库中应用一致模式时。
提示词："Transform the auth module from callbacks to async/await in project proj_abc123"integrate_pm
将项目管理工具和工作流与 Planu 集成 — 从规格创建 issue、epic 或任务。
支持： Jira、Linear、GitHub Issues、GitLab Issues、Trello、Notion。
提示词："Create a GitHub issue for spec SPEC-004 in project proj_abc123"
提示词："Create a Linear task for spec SPEC-009 in project proj_abc123"update_registry
向本地注册表添加自定义框架条目。
适用场景： 当你的项目使用 Planu 内置目录未识别的框架时 — 添加后 suggest_stack、check_versions 和 suggest_tooling 可以使用它。
提示词："Add my custom framework 'acme-framework' v2.1 to the local registry for project proj_abc123"manage_hooks
为项目配置和管理 Git 钩子 — pre-commit、post-merge、pre-push — 与规格验证和质量门关联。
适用场景： 在设置或修改强制执行 SDD 工作流规则的 Git 钩子时。
提示词："Set up pre-commit hooks for spec validation in project proj_abc123"start_hooks
为项目启动文件监视器和钩子引擎。
适用场景： 在活跃开发会话期间激活实时钩子处理。
提示词："Start the hook engine for project proj_abc123"stop_hooks
停止文件监视器和钩子引擎。
提示词："Stop the hook engine for project proj_abc123"hook_status
获取钩子引擎的当前状态 — 是否正在运行、哪些钩子处于活跃状态以及最近的触发历史。
提示词："Check hook engine status for project proj_abc123"configure_hooks
在运行时查看或更新钩子引擎配置，无需重启。
适用场景： 在不停止和重启引擎的情况下更改冷却间隔、启用/禁用特定钩子或调整钩子优先级。
提示词："Configure hooks to increase cooldown to 60 seconds for project proj_abc123"流程 G — Git 与 CI
manage_git
管理 Git 操作：分支、提交、推送、PR — 与规格关联以实现完整可追溯性。
提示词："Create a branch for spec SPEC-005 in project proj_abc123"
提示词："Generate a PR description for spec SPEC-005 in project proj_abc123"
提示词："Generate a changelog from specs SPEC-001 through SPEC-010 for project proj_abc123"create_pr_from_spec
从规格创建 GitHub Pull Request — 自动填充标题、正文、标签和链接的规格元数据。
适用场景： 在实现规格后，希望打开一个带有完整 SDD 可追溯性（规格 ID、验收标准、实现说明）的 PR 时。
提示词："Create a PR from spec SPEC-012 in project proj_abc123"review_pr
分析 Pull Request 差异以获取审查结果 — 检查规格合规性、代码模式和质量问题。
适用场景： 在批准 PR 之前，或作为 CI 中的自动步骤以尽早发现规格漂移。
提示词："Review PR #88 for project proj_abc123"pr_status
列出带审查状态和 CI 检查的开放 Pull Request。
适用场景： 在规划或站立会议之前，快速了解所有进行中 PR 及其阻塞状态。
提示词："Show PR status for project proj_abc123"create_release
创建带自动生成发布说明的 GitHub Release，发布说明来自合并的规格和 PR。
提示词："Create a release v2.1.0 for project proj_abc123"generate_changelog
从两个 Git 引用之间的合并 Pull Request 生成变更日志。
适用场景： 在发布之前，汇编自上一个标签以来所有变更的人类可读摘要。
提示词："Generate a changelog from v2.0.0 to HEAD for project proj_abc123"流程 H — 编排与上下文
orchestrate
协调和执行复杂的多步骤工作流 — 注册代理、锁定资源、分配任务并管理并行执行状态。
提示词："Register an agent for spec SPEC-011 and lock the auth module in project proj_abc123"orchestrate_runtime
使用可配置拓扑（扇出、流水线、共识）启动和协调并行代理。
适用场景： 在并行运行 3 个以上独立实现任务时，需要集中状态管理、冲突检测和结果聚合。
提示词："Launch a fan-out orchestration for specs SPEC-020 through SPEC-025 in project proj_abc123"orchestrate_agents
为并行或顺序任务执行编排多个 AI 代理 — 声明能力、路由任务、生成交接上下文，并在执行前检测文件归属冲突。
提示词："Orchestrate agents for specs SPEC-012, SPEC-013, SPEC-014 in project proj_abc123"agent_swarm_status
获取编排会话状态：代理进度、任务状态、指标和成本。
适用场景： 在并行代理会话期间或之后，监控哪些代理被阻塞、已完成或失败。
提示词："Show swarm status for orchestration session orch_abc123"validate_team_results
在并行执行后验证所有团队成员的综合结果 — 检查冲突、缺失输出和规格合规性。
适用场景： 在 orchestrate_agents 完成后、合并并行分支之前。
提示词："Validate team results for orchestration session orch_abc123 in project proj_abc123"manage_context
跨规格和项目管理和优化上下文使用 — 保存、加载和管理持久化上下文笔记。
适用场景： 当你需要保留未在规格中记录的重要架构决策、外部约束或团队协议时。
提示词："Save context: we decided to use Postgres 16 with pgvector for all AI features in project proj_abc123"
提示词："What context have we saved for project proj_abc123?"context_budget
查看和管理 AI 辅助开发的上下文词元预算。
操作：
status— 检查当前词元使用情况、警报级别和最大消耗者configure— 设置上下文窗口大小和警告/严重阈值checkpoint— 保存会话状态（决策、文件、规格、Git 状态）以确保连续性restore— 加载之前的检查点以在新会话中恢复工作list-checkpoints— 显示可用的会话检查点optimize— 获取减少上下文压力的委派建议
提示词："Check my context budget status"
提示词："Save a checkpoint of this session"
提示词："What should I delegate to subagents?"token_intelligence
高级词元分析：成本跟踪、预算监控、估算准确性、趋势检测和异常警报。
适用场景： 在运行长时间或昂贵的代理会话时，需要了解词元花费在哪里、估算是否准确以及在哪里削减成本。
提示词："Show token intelligence report for project proj_abc123"
提示词："Alert me if any session exceeds 50k tokens"consult_docs
无需离开 CLI 即可搜索和查阅项目文档 — 在上下文中获取和总结相关文档。
提示词："Consult React docs about concurrent rendering for project proj_abc123"
提示词："What does the FastAPI docs say about dependency injection?"migrate_tech
规划和执行技术迁移 — 分析源代码库、映射等效关系、生成迁移计划、验证功能一致性并规划数据库迁移。
适用场景： 在从一个框架迁移到另一个框架（Express → Fastify、Django → FastAPI、Create React App → Vite）、升级主要依赖或迁移数据库时。
提示词："Plan a migration from Express to Fastify for project proj_abc123"
提示词："Migrate from class-based to functional React components in project proj_abc123"ecosystem_status
扫描外部生态系统来源，获取与项目技术栈相关的新能力、模式和集成机会。
适用场景： 在新阶段开始时或每季度，保持与框架发布、新 MCP 服务器和新兴工具模式的同步。
提示词："Run ecosystem status scan for project proj_abc123"generate_infrastructure
从规格生成基础设施即代码（IaC） — Terraform、Pulumi、CDK、Helm chart 或 Docker Compose。
适用场景： 当规格包含基础设施需求（数据库、队列、缓存、无服务器函数），且希望使用可重现的 IaC 而不是手动配置时。
提示词："Generate Terraform for the database spec SPEC-030 in project proj_abc123"
提示词："Generate a Helm chart for the API deployment in spec SPEC-031"流程 I — 治理与运维
configure_roles
为项目启用或禁用基于角色的访问控制（RBAC） — 定义哪些角色可以创建、批准或实现规格。
提示词："Enable RBAC for project proj_abc123 with roles: architect, developer, reviewer"assign_role
为用户分配项目或特定规格的角色。
适用场景： 在新团队成员入职时，定义他们在 SDD 工作流中的权限。
提示词："Assign the 'developer' role to alice@example.com in project proj_abc123"configure_workers
配置后台分析工作进程：启用/禁用、设置冷却时间、设置优先级。
可用工作进程： 漂移检测器、约定扫描器、规格健康监控器、依赖审计器、自动记忆注入器。
提示词："Enable the drift detector worker with a 30-minute cooldown for project proj_abc123"
提示词："Set the convention scanner to high priority for project proj_abc123"worker_status
显示后台分析工作进程的状态 — 哪些正在运行、上次运行时间和最近发现。
提示词："Show worker status for project proj_abc123"configure_llm_providers
为多提供商支持配置 LLM 提供商 — 添加 API 密钥、设置路由规则并定义回退链。
支持的提供商： Anthropic、OpenAI、Google Gemini、Mistral、Groq、Ollama（本地）。
提示词："Add OpenAI as a secondary LLM provider for project proj_abc123"llm_provider_status
显示所有已配置 LLM 提供商的状态，包括健康状况、延迟和成本跟踪。
提示词："Show LLM provider status for project proj_abc123"configure_observability
配置 OpenTelemetry（OTel）追踪和指标 — 将 span 导出到 Jaeger、Grafana Tempo、Datadog 或 Honeycomb。
适用场景： 在团队环境中运行 Planu 时，希望对代理会话和工具调用进行分布式追踪。
提示词："Configure OpenTelemetry export to Grafana Tempo for project proj_abc123"manage_plugins
列出、安装、激活、停用、卸载或获取 Planu 插件信息。
适用场景： 在使用打包为插件的自定义工具或第三方集成扩展 Planu 时。
提示词："List all installed plugins for project proj_abc123"
提示词："Install the linear-sync plugin"
提示词："Deactivate the jira-integration plugin"scaffold_plugin
生成带清单、入口点、测试和示例的插件项目起始代码。
适用场景： 在构建自定义 Planu 插件时，希望获得遵循插件 API 契约的完整结构化起始点。
提示词："Scaffold a new Planu plugin called 'notion-sync' for project proj_abc123"token_usage
查看词元消耗指标、缓存性能和优化节省。
适用场景： 了解团队花费了多少词元、哪些工具最昂贵以及缓存节省了多少。
提示词："Show token usage for project proj_abc123"submit_feedback
直接从对话中提交关于 Planu 的错误报告、功能请求或建议。
输入：
type—bug（错误）、feature（功能）、suggestion（建议）或dx（开发体验）title— 反馈的简短摘要description— 详细说明context（可选）— 相关的项目 ID、规格 ID 或工具名称
反馈会存储在本地并匿名发送到 Planu 的中央追踪器。
提示词："I want to report a bug with the estimate tool"
提示词："Submit a feature request: I'd like create_spec to support importing from Notion"
提示词："I have a suggestion about the onboarding flow"triage_feedback
查看和优先处理按相似度分组的待处理用户反馈 — 帮助团队决定下一步处理哪些内容。
输出内容：
- 分组的反馈项（使用相似度评分合并相似的错误和请求）
- 每组的优先级评分（频率 × 严重程度）
- 每组建议的操作：
create_spec（创建规格）|merge（合并）|dismiss（忽略）
提示词："Triage all pending feedback"
提示词："Show me pending bug reports"
提示词："Triage feature requests for project proj_abc123"resolve_feedback
将反馈标记为已解决，并链接到处理它的规格和 Pull Request — 创建从用户反馈到已交付修复的完整可追溯链。
输入：
feedbackId— 要解决的反馈项 IDspecId（可选）— 处理该反馈的规格prUrl（可选）— 交付修复的 Pull Request URLnotes（可选）— 解决说明或上下文
提示词："Mark feedback fb_001 as resolved, linked to SPEC-042"
提示词："Resolve feedback fb_003 with PR https://github.com/org/repo/pull/88"registry_search
在 Planu 规格注册表中搜索可复用规格 — 查找与功能需求匹配的社区贡献规格。
提示词："Search the Planu registry for authentication specs"
提示词："Find specs related to payment processing in the registry"registry_install
从 Planu 注册表将规格安装到本地项目。
适用场景： 使用 registry_search 找到相关规格后，将其作为自己实现的起始点添加。
提示词："Install spec planu/stripe-checkout into project proj_abc123"configure_oauth
检查或测试 Planu HTTP 传输的 OAuth 2.1 Bearer 令牌身份验证。
适用场景： 在以 HTTP 服务器模式（非 stdio）运行 Planu 时，需要使用 API 密钥或 HMAC 签名 JWT 令牌进行保护。
输出内容：
- 保存 OAuth 配置（模式：
api-key或jwt） - 返回要设置的环境变量名称（
SDD_OAUTH_API_KEY或SDD_OAUTH_JWT_SECRET） - 确认传输现在受到保护的验证摘要
提示词："Configure OAuth for my Planu HTTP server using API key mode"