技能 revise
📦

revise

低风险 ⚙️ 外部命令

根据审阅者评论修订 P11 文档

与多位协作者一起审阅 p11 文档会产生分散的反馈,手动应用起来很困难。此技能会读取审阅者评论,按清晰度对其分类,将明确的决策应用到源文档,并自动发布新版本。

支持: Claude Codex Code(CC)
📊 75 合格
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文、而不是读取完整页面时,请使用这些链接。

测试它

正在使用“revise”。 将我设计提案文档上的反馈应用进去,团队要求我添加摘要部分并重新排序需求列表。

预期结果:

我审阅了你设计提案上的 8 个评论线程。我发现 6 个明确决策,以及 2 个需要你输入的事项。我已应用所有明确更改:在介绍之后添加了摘要部分,按优先级重新排序了需求列表,并更新了时间线表格。以下是更新后的 Read URL 和 Edit URL。

正在使用“revise”。 使用版本 3 中的审阅评论更新 API 文档。

预期结果:

我获取了 API 文档的版本 3,并发现 5 个评论线程。所有评论都有明确决策,因此我已全部应用:更正了身份验证部分中的 endpoint URLs,添加了新的 rate limit parameters 表格,并修复了 response format 示例。修订后的文档已发布在新的 Read URL。

安全审计

低风险
v1 • 5/23/2026

All 57 static findings are false positives. Weak cryptographic algorithm flags were triggered by a hex color code ("#2563EB" in openai.yaml:3), a React component name ("DefinitionDescription" in components.md:34), and YAML metadata fields (SKILL.md:3-5). Ruby/shell backtick execution flags were triggered by Markdown code block backticks in code fences across SKILL.md and components.md. The system reconnaissance flag on SKILL.md:92 is actually security-conscious guidance about bearer credentials. The skill has legitimate external command usage via the p11 CLI, which is expected and necessary for its document revision workflow. No malicious intent detected.

3
已扫描文件
160
分析行数
4
发现项
1
审计总数
低风险问题 (3)
False Positive: Weak Cryptographic Algorithm Detection
Static scanner flagged hex color code '#2563EB' (openai.yaml:3), component name 'DefinitionDescription' (components.md:34), and YAML description fields (SKILL.md:3-5) as weak cryptographic algorithms. None of these are cryptographic material. Hex color codes and component names are false positives for crypto detection patterns.
False Positive: Markdown Backticks as Ruby Shell Execution
Static scanner misidentified Markdown code fence backticks as Ruby shell backtick execution. All 52 flagged instances across SKILL.md and components.md are standard Markdown code block formatting (triple ``` or inline ` backticks) for displaying code or bash command examples, not shell command execution.
False Positive: System Reconnaissance
Static scanner flagged SKILL.md:92 as system reconnaissance. This line instructs the AI to 'Treat edit URLs as bearer credentials and avoid exposing them unnecessarily.' This is security-conscious guidance about credential handling, not reconnaissance activity.

检测到的模式

External Command Execution via p11 CLI
审计者: claude

质量评分

41
架构
100
可维护性
87
内容
65
社区
84
安全
100
规范符合性

你能构建什么

在团队审阅后更新设计提案

设计师收到关于功能提案文档的反馈。该技能会应用审阅者评论中的所有明确决策,并发布更新版本以供最终批准。

将技术审阅反馈应用到文档

工程师收集技术文档上的审阅评论。该技能会处理每条评论,进行请求的更改,并共享修订后的文档。

批量处理多轮文档审阅

团队负责人管理跨多轮的迭代式文档审阅。该技能会跟踪哪些评论已应用,以及哪些仍需要讨论。

试试这些提示

基础文档修订
使用 p11:revise 根据审阅者反馈更新最近的 p11 文档。获取评论并应用所有明确的决策。
从特定版本修订
从版本 [number] 修订 edit URL [url] 处的 p11 文档。获取该版本的评论,并仅应用明确的决策。
处理不明确或有争议的评论
对当前文档使用 p11:revise。对所有可见评论线程进行分类。如果有任何需要澄清的内容,请在发布前询问我如何继续。
带组件参考的完整文档审阅
修订 [url] 处的文档。先阅读组件参考,然后获取所有评论。应用明确的决策并发布。报告已完成哪些更改,以及哪些需要我的输入。

最佳实践

  • 在进行更改前,始终按内容对评论线程进行分类。并非所有未解决评论都需要采取行动。
  • 当任何评论线程需要人工澄清时,请在发布前先与用户确认。
  • 编辑前阅读 p11 组件参考,以确保只使用受支持的文档组件。

避免

  • 默默忽略需要人工澄清的可见评论线程。始终询问用户如何继续。
  • 在未先获取并审阅目标文档上的所有评论之前发布修订版本。
  • 向文档添加按钮或表单等交互式 UI 元素。仅使用 p11 library 中适合文档的组件。

常见问题

此技能可以修订哪些类型的文档?
此技能适用于 p11 可共享文档。这些是使用 p11 platform 创建的基于 React 的文档。
该技能会自动处理所有审阅者评论吗?
不能。该技能会自动应用明确的决策,但当评论需要澄清或存在争议时,会请求你的输入。
技能无法理解的评论会怎样处理?
需要澄清的评论会被标记。该技能会询问你是想回复以获取更多信息,还是暂时跳过它们。
我需要安装任何东西才能使用此技能吗?
需要。必须全局安装 p11 CLI。如有需要,该技能可以使用 npm install -g @p11-core/cli@latest 安装它。
我可以修订文档的特定版本吗?
可以。你可以提供版本号来修订 p11 文档的任何历史版本。
该技能如何知道要修订哪个文档?
它会使用你提供的文档 URL 或 ID。如果你没有指定,则会使用对话中最近的 p11 文档。

开发者详情

文件结构