Use when you have a written implementation plan to execute in a separate session with review checkpoints
npx skills add nesnilnehc/ai-cortex --skill "decontextualize-text"
Install specific skill from multi-skill repository
# Description
将带私有背景或内部依赖的文本转为通用、无偏见的表达。在抽象方法论、跨团队知识共享、脱敏处理及准备公开文档时使用。
# SKILL.md
name: decontextualize-text
description: 将带私有背景或内部依赖的文本转为通用、无偏见的表达。在抽象方法论、跨团队知识共享、脱敏处理及准备公开文档时使用。
tags: [writing, security, privacy, generalization]
related_skills: [generate-standard-readme]
version: 1.2.0
recommended_scope: user
Skill: 去上下文化 (Decontextualize Text)
目的 (Purpose)
将带有私有背景、隐含上下文或特定环境依赖的内容,转换为通用、可复用的表达。通过移除或替换特定标识符,使内容在不同环境(跨团队、跨公司、公共领域)中均能被正确理解,同时保护组织隐私。
适用场景 (Use Cases)
- 知识泛化:将特定项目的经验总结抽象为通用的方法论或最佳实践。
- 跨团队协作:移除仅内部团队可理解的黑话、代号,使协作方能无障碍阅读文档。
- 内容脱敏:在分享案例或技术博客时,过滤掉敏感的项目名称、人员信息和内部地址。
- 发布准备:作为将内部内容同步到外部公共环境(如开源、移交)的最后清理步骤。
- 文档同步:在分叉 (Fork) 或合并 (Merge) 跨组织代码库后,清理过时的环境依赖描述。
何时使用:当需要打破“由于环境差异带来的理解阻碍”或“信息安全边界”时。
行为要求 (Behavior)
核心原则
- 保留「做什么」与「为什么」。
- 去除「是谁」「在哪」「基于什么内部条件」。
- 将专有名词替换为通用描述(如“内部系统”“某业务流程”)。
- 将隐含前提改为显式前提,或直接移除。
交互策略 (Interaction Policy)
- 疑似核对:当识别到可能具有敏感属性但无法确定其通用性的词汇(如不确定的缩写或内部服务器代号)时,必须先列出清单请用户确认,而非直接重载。
- 多选重写:针对核心逻辑,可提供 2-3 种不同抽象程度的重写方案供用户选择。
处理流程
- 识别敏感词:扫描文本中的公司名、项目代号、内部服务器地址、人员姓名。
- 提取核心逻辑:分析操作步骤的本质(例如“JIRA 审批”本质是“任务状态变更评审”)。
- 通用化重写:使用中性词汇重写识别出的部分。
- 结构对齐:确保改动后的段落结构与原文保持一致,不丢失能力边界。
输入与输出 (Input & Output)
输入 (Input)
- 包含以下一种或多种特征的文本:
- 特定组织、公司、项目、系统名称。
- 内部约定、隐含背景、默认前提。
- 仅在特定环境下成立的流程或假设。
输出 (Output)
- 通用版本:去除或替换私有上下文后的文本。
- 结构化保留:输出必须严格保留原有的逻辑层级、Markdown 格式及功能性指令。
- 可复用性:输出应达到“即插即用”的标准,无需第三方额外获取背景知识。
禁止行为 (Restrictions)
- 禁虚构:不得虚构原文中不存在的背景或能力。
- 禁推断:不得补充未明确给出的事实或结论。
- 禁注入:不得引入新的业务语义。
- 禁残留:不得保留任何可反向识别具体组织或个人的信息(如唯一性高的代数、内部流程编号、非公开术语等)。
质量检查 (Self-Check)
- [ ] 独立性:不知道原始上下文,也能完全理解内容。
- [ ] 匿名性:难以通过搜索推断其来源于哪家公司或项目。
- [ ] 一致性:核心逻辑和功能与原文完全一致。
- [ ] 合规性:符合数据脱敏规范或公共发布的隐私安全标准。
示例 (Examples)
示例 1:内部流程 → 通用表述
| 原文 | 去上下文化后 |
|---|---|
| 在 Acme 的 JIRA 工作流中,当需求进入「技术评审」时,先跑一遍 X 团队的 Checklist,再通知 PM 李四。 | 当需求进入「技术评审」阶段时,执行既定 Checklist,并通知相关产品负责人。 |
示例 2:系统与调用方式 → 中性描述
| 原文 | 去上下文化后 |
|---|---|
| 用我们公司的 LLM Gateway (api.acme.internal) 调用 gpt-4,超时 30s。 | 通过 LLM API 调用模型,建议设置合理超时(如 30s)。 |
示例 3:多维度指令 → 抽象逻辑
| 原文 | 去上下文化后 |
|---|---|
按照 Kiro 团队的规范,Python 代码必须通过 pylint 检查且分数高于 9.0 才能提交到 master 分支。 |
按照代码质量规范,代码应通过静态扫描(如 pylint)并达到预设质量阈值后,方可合并至主分支。 |
# Supported AI Coding Agents
This skill is compatible with the SKILL.md standard and works with all major AI coding agents:
Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.