文档协议
"写作就是思考。写得好就是思考清楚。这就是为什么它如此困难。"
— 大卫·麦卡洛 (David McCullough)
文档协议简介
文档协议将混乱的内容创作过程转变为结构化、高效的工作流,持续产出高质量结果。它们为组织想法、管理信息和制作引人注目的内容提供架构框架——同时优化您与AI系统的交互。
┌─────────────────────────────────────────────────────┐
│ │
│ 文档协议的优势 │
│ │
│ • 一致的文档质量和结构 │
│ • 减少创作过程中的认知开销 │
│ • 人类和AI之间的高效协作 │
│ • 从概念到完成的清晰进展 │
│ • 复杂文档的优化token使用 │
│ • 内容随时间可维护和可演化 │
│ │
└─────────────────────────────────────────────────────┘本指南为常见的内容创作场景提供可立即使用的文档协议,配有实施指导和性能指标。每个协议都遵循我们的NOCODE原则:导航(Navigate)、编排(Orchestrate)、控制(Control)、优化(Optimize)、部署(Deploy)和演化(Evolve)。
如何使用本指南
- 选择协议,匹配您的文档创作目标
- 复制协议模板并自定义占位符
- 在交互开始时向AI助手提供协议
- 遵循结构化过程,从初始概念到最终文档
- 监控指标以评估有效性
- 迭代和优化您的协议以供未来使用
苏格拉底式提问:您发现最难创建的文档类型是什么?文档创作过程的哪些方面消耗了最多的时间和精神能量?
1. 结构化文章协议
何时使用此协议: 需要创建全面、结构良好的文章,有效传达复杂信息?此协议指导您开发具有清晰组织、平衡深度和引人入胜内容的文章——非常适合博客文章、教育内容、思想领导力作品或技术解释。
/document.article{
intent="创建关于特定主题的全面、结构良好的文章",
input={
topic="[文章主题]",
target_audience="[主要读者及其知识水平]",
key_points=["[要点_1]", "[要点_2]", "[要点_3]", "[根据需要添加]"],
tone="[期望语调: 学术/对话/说服等]",
length="[大约字数]",
special_elements="[任何特定包含内容: 示例/案例研究/数据等]"
},
process=[
/outline{
action="创建详细的层次结构",
format="包含章节和子章节的大纲"
},
/develop{
action="将大纲扩展为完整内容",
sections=[
/introduction{
elements=["钩子", "背景", "论点", "路线图"],
purpose="吸引读者并建立框架"
},
/body{
approach="想法的逻辑进展",
section_pattern=[
"关键点陈述",
"支持证据/解释",
"说明性示例",
"影响或应用"
]
},
/conclusion{
elements=["摘要", "更广泛的背景", "行动号召/未来方向"],
purpose="强化关键信息并提供闭合"
}
]
},
/enhance{
elements=[
"章节间的过渡短语",
"多样化的句子结构",
"精确而引人入胜的词汇",
"适合语调的修辞手法"
]
},
/finalize{
action="审查和优化完整文章",
checks=["清晰度", "流畅性", "语调一致性", "证据力度"]
}
],
output={
final_article="具有清晰结构和引人入胜内容的完整文章",
key_messages="文章中提出的中心点摘要",
suggested_title="推荐标题和可能的替代方案",
outline_reference="最终结构供未来参考"
}
}
我想按照此协议使用我提供的信息创建一篇文章。请确认并从大纲开始。实施指南
主题定义:
- 要具体而非笼统
- 框定为集中的问题或陈述
- 考虑广度(覆盖范围)和深度(详细程度)
受众规范:
- 定义人口统计、知识水平和兴趣
- 考虑他们阅读此内容的动机
- 识别他们从文章中寻求的价值
关键点选择:
- 识别3-7个核心信息或论点
- 确保点之间逻辑构建
- 平衡覆盖广度与有意义的深度
语调设置:
- 使语调与受众和目的匹配
- 考虑适当的词汇和句子结构
- 在整个文档中保持一致性
性能指标
| 指标 | 描述 | 目标 |
|---|---|---|
| 结构完整性 | 逻辑组织和流畅性 | 清晰的层次结构和平滑过渡 |
| 内容深度 | 要点发展的彻底性 | 每个关键点的实质性探索 |
| 参与价值 | 读者兴趣和保留 | 引人注目的钩子和多样化的节奏 |
| 信息清晰度 | 关键点的可理解性 | 不可错认的中心信息 |
应用示例
/document.article{
intent="创建关于特定主题的全面、结构良好的文章",
input={
topic="生成式AI对内容创作工作流的影响",
target_audience="具有基本AI知识但技术专业知识有限的营销专业人士",
key_points=[
"AI从根本上改变内容创作经济学",
"人机协作需要新的工作流和技能",
"质量控制比初始创作更重要",
"伦理考虑应融入新流程"
],
tone="信息丰富但对话式,前瞻但实用",
length="1200-1500字",
special_elements="包括实际示例、小型案例研究和可操作的要点"
},
process=[...],
output={...}
}2. 技术文档协议
何时使用此协议: 创建需要清晰、准确和全面的技术文档?此协议构建技术指南、API文档、产品手册或流程文档的开发,重点关注可用性、技术准确性和适当的详细级别。
/document.technical{
intent="创建精确、可用的技术文档",
input={
subject="[要记录的系统/产品/流程]",
documentation_type="[指南/参考/API文档/手册等]",
target_users="[主要用户及其专业水平]",
key_components=["[组件_1]", "[组件_2]", "[组件_3]", "[根据需要添加]"],
technical_depth="[基础/中级/高级]",
usage_context="[文档将如何及在何处使用]"
},
process=[
/structure{
action="创建逻辑文档架构",
elements=[
"概述部分",
"先决条件信息",
"逐个组件的详细信息",
"交叉引用和关系",
"故障排除或常见问题部分"
]
},
/develop{
action="以适当的详细程度构建技术内容",
sections=[
/overview{
elements=["目的", "范围", "架构", "关键概念"],
purpose="提供背景和高层理解"
},
/component_details{
for_each="key_component",
structure=[
"组件目的和背景",
"技术规格",
"使用说明或示例",
"限制和考虑因素"
]
},
/cross_references{
action="建立组件之间的连接",
elements=["依赖关系", "交互", "工作流"]
},
/troubleshooting{
structure=["常见问题", "诊断步骤", "解决方案"],
purpose="实现自助问题解决"
}
]
},
/enhance{
elements=[
"清晰的图表或视觉辅助",
"代码示例或配置示例",
"重要信息的标注",
"一致的术语和定义"
]
},
/finalize{
action="审查和验证技术准确性",
checks=["正确性", "完整性", "可用性", "可访问性"]
}
],
output={
final_documentation="具有适当结构和详细信息的完整技术文档",
terminology_glossary="关键技术术语的定义",
usage_examples="展示应用的实际示例",
improvement_areas="未来文档增强的建议"
}
}
我想按照此协议使用我提供的信息创建技术文档。请确认并从文档结构开始。实施指南
主题定义:
- 清楚地定义范围和边界
- 识别要记录的特定版本或迭代
- 考虑系统架构和组件关系
文档类型选择:
- 指南:流程的分步说明
- 参考:用于查找的全面信息
- API文档:接口规格和使用
- 手册:完整的产品或系统操作
用户规范:
- 定义主要用户的技术专业水平
- 考虑具有不同需求的次要用户群
- 识别常见使用场景和用户目标
组件优先级排序:
- 列出主要功能区域或系统组件
- 根据重要性和使用频率确定优先级
- 考虑逻辑分组和关系
性能指标
| 指标 | 描述 | 目标 |
|---|---|---|
| 技术准确性 | 所有信息的正确性 | 100%准确性 |
| 完整性 | 所有必要组件的覆盖 | 无功能空白 |
| 可用性 | 查找和应用信息的便利性 | 2-3次点击/步骤内可访问信息 |
| 示例质量 | 示例的实用性和清晰度 | 直接适用于常见场景 |
应用示例
/document.technical{
intent="创建精确、可用的技术文档",
input={
subject="客户数据管理系统v2.1的RESTful API",
documentation_type="带使用指南的API参考",
target_users="具有中级REST经验的后端开发人员,一些新接触我们特定实现",
key_components=[
"身份验证和授权",
"客户记录端点",
"交易历史端点",
"批量操作",
"速率限制和配额"
],
technical_depth="中级带高级部分",
usage_context="在开发实施期间使用,用于故障排除"
},
process=[...],
output={...}
}3. 高管简报协议
何时使用此协议: 需要向忙碌的决策者简明地传递复杂信息?此协议创建专注的执行摘要、简报或备忘录,高效地传递必要信息,同时保持影响力和可操作性。
/document.executive_brief{
intent="为决策者创建简洁、有影响力的简报",
input={
topic="[简报主题]",
key_points=["[要点_1]", "[要点_2]", "[要点_3]", "[根据需要添加]"],
decision_context="[此简报支持的决策或行动]",
audience="[特定决策者及其优先事项]",
data_elements="[要包括的关键数据点]",
length_constraint="[最大长度或阅读时间]"
},
process=[
/prioritize{
action="根据决策相关性识别和排列信息",
criteria=["对决策的影响", "紧迫性", "战略一致性"]
},
/structure{
action="创建适合高管的格式",
elements=[
"标题摘要(关键信息)",
"背景(最少必要背景)",
"洞察(关键发现和影响)",
"建议(清晰、可操作的后续步骤)",
"支持证据(选定的高影响数据)"
]
},
/develop{
action="制作简洁、精确的内容",
approach=[
"使用高管词汇和语调",
"强调洞察而非过程",
"关注业务影响",
"保持简洁而不牺牲清晰度"
]
},
/enhance{
elements=[
"视觉数据呈现",
"问题的高管框架",
"清晰的决策路径",
"风险和机会评估"
]
},
/finalize{
action="优化即时理解",
checks=["清晰度", "可操作性", "战略一致性", "简洁性"]
}
],
output={
executive_brief="为决策者消费优化的简洁文档",
key_takeaways="单句核心信息",
recommended_actions="优先行动项",
supporting_data="选定的高影响证据点"
}
}
我想按照此协议使用我提供的信息创建高管简报。请确认并从优先处理关键信息开始。实施指南
主题框架:
- 以业务影响或战略相关性的术语表达
- 专注于结果而非过程
- 以决策者的语言框架,而非技术术语
决策背景阐明:
- 指定此简报将告知的确切决策
- 注意决策的时间线
- 识别影响决策的约束或考虑因素
受众分析:
- 定义具体角色和责任
- 注意每个决策者的特定关注或优先事项
- 考虑现有知识和偏好
数据选择:
- 只选择最有影响力的指标或发现
- 专注于前瞻性影响而非历史细节
- 以业务术语呈现数据(收入、成本、增长、风险)
性能指标
| 指标 | 描述 | 目标 |
|---|---|---|
| 简洁性 | 沟通效率 | 目标时间内可读(通常3-5分钟) |
| 高管相关性 | 与决策者优先事项的一致性 | 与战略关注的直接联系 |
| 可操作性 | 后续步骤的清晰度 | 明确的建议 |
| 影响清晰度 | 重要性的明显性 | 清晰的业务影响 |
应用示例
/document.executive_brief{
intent="为决策者创建简洁、有影响力的简报",
input={
topic="拟议扩展到东南亚市场:机会分析和进入策略",
key_points=[
"泰国和越南提供最高的即时投资回报率,预计利润率为28%",
"分阶段进入策略与同步发布相比减少40%的资本需求",
"与LocalTech Inc.的战略合作伙伴关系减轻监管风险并加速市场准入",
"竞争格局显示在主要竞争对手进入之前有12-18个月的窗口"
],
decision_context="董事会需要在下次会议上批准1500万美元的初始投资和合作伙伴协议",
audience="具有不同国际经验的董事会成员,特别关注风险管理和资本效率",
data_elements="市场规模预测、竞争对手分析、各阶段资本需求、风险评估矩阵",
length_constraint="最多5分钟阅读,一页执行摘要"
},
process=[...],
output={...}
}4. 教学内容协议
何时使用此协议: 创建旨在教授技能或程序的内容?此协议开发教育材料,重点关注学习进展、知识保留和实际应用——非常适合教程、操作指南、培训材料或教育内容。
/document.instructional{
intent="创建有效的以学习为重点的内容",
input={
subject="[要教授的技能或知识]",
learner_profile="[目标学习者及其起点]",
learning_objectives=["[目标_1]", "[目标_2]", "[目标_3]", "[根据需要添加]"],
prerequisite_knowledge="[学习者应该已经知道的内容]",
format="[教程/指南/课程等]",
engagement_approach="[如何保持学习者兴趣]"
},
process=[
/structure{
action="设计学习进展",
approach=[
"从基础到高级排序概念",
"将信息分块为可管理的部分",
"为复杂概念融入脚手架",
"建立知识验证点"
]
},
/develop{
action="以教学重点创建教学内容",
sections=[
/introduction{
elements=["学习目标", "与学习者的相关性", "进展概述"],
purpose="建立学习的动机和背景"
},
/core_content{
for_each="learning_objective",
structure=[
"概念解释",
"演示或示例",
"引导练习机会",
"常见陷阱和解决方案"
]
},
/reinforcement{
elements=["摘要", "练习", "实际应用"],
purpose="巩固和应用新知识"
}
]
},
/enhance{
elements=[
"视觉学习辅助(图表、图表等)",
"不同学习风格的多样化示例",
"复杂概念的类比和隐喻",
"知识验证检查点"
]
},
/finalize{
action="优化学习有效性",
checks=["清晰度", "参与度", "知识构建", "实际应用"]
}
],
output={
instructional_content="具有有效进展的完整以学习为重点的内容",
quick_reference="关键概念摘要供以后审查",
practice_materials="技能发展的练习或活动",
instructor_notes="教学或促进指导(如果适用)"
}
}
我想按照此协议使用我提供的信息创建教学内容。请确认并从设计学习进展开始。实施指南
主题定义:
- 定义要教授的具体技能或知识
- 建立包含/排除的明确边界
- 将复杂主题分解为可教授的组件
学习者资料开发:
- 定义先前知识和经验水平
- 识别学习此主题的动机
- 考虑潜在的挑战或误解
学习目标制定:
- 编写具体的、可测量的目标
- 使用指示掌握水平的行动动词
- 确保目标逐步构建
格式选择:
- 教程:特定任务的分步指导
- 指南:带应用的全面概述
- 课程:结构化、多模块学习体验
- 参考:持续使用的组织信息
性能指标
| 指标 | 描述 | 目标 |
|---|---|---|
| 概念清晰度 | 解释的可理解性 | 目标学习者资料可访问 |
| 学习进展 | 知识的逻辑构建 | 从基础到精通的清晰路径 |
| 参与度 | 学习者兴趣的保持 | 保持注意力的多样化方法 |
| 应用支持 | 知识的实际使用 | 多个应用学习的机会 |
应用示例
/document.instructional{
intent="创建有效的以学习为重点的内容",
input={
subject="使用Tableau进行数据可视化基础",
learner_profile="具有基本数据素养但无可视化工具经验的营销专业人士",
learning_objectives=[
"连接并准备可视化的数据源",
"为不同分析目的创建五种基本图表类型",
"设计组合多个可视化的交互式仪表板",
"应用清晰和视觉传达的最佳实践"
],
prerequisite_knowledge="对数据概念(指标、维度)的基本理解,对电子表格的熟悉",
format="带渐进式练习的动手教程",
engagement_approach="真实世界的营销数据示例,渐进式挑战,视觉前后比较"
},
process=[...],
output={...}
}5. 说服性文档协议
何时使用此协议: 需要影响决策、改变意见或激发行动?此协议开发结构化的说服性内容以最大化影响并推动期望结果——非常适合提案、销售材料、宣传内容或变革管理沟通。
提示:我需要创建一个令人信服的商业提案,以确保我们新SaaS平台的资金。我的受众是一组具有技术背景的风险投资家,他们正在寻找具有明确市场潜力的创新解决方案。我需要说服他们在我们的第一轮融资中投资200万美元。请将其构建为说服性文档,解决他们可能关注的市场规模、竞争和我们执行能力的问题。
协议:
/document.persuasive{
intent="创建旨在影响和推动行动的内容",
input={
proposition="在我们SaaS平台的初始融资轮中投资200万美元",
target_audience="专注于技术的风险投资家,寻求具有市场潜力的创新解决方案",
desired_outcome="以有利条款获得200万美元融资",
key_motivators=[
"显著投资回报率的潜力(5年内10倍)",
"优于竞争对手的独特技术优势",
"与已建立的客户兴趣的清晰市场路径",
"具有领域专业知识的经验丰富的团队"
],
potential_objections=[
"市场可能太小众或竞争太激烈",
"技术在规模上仍未经证实",
"执行团队缺乏以前的退出经验"
],
evidence_available="市场分析、工作原型、潜在客户的意向书、团队资格、财务预测"
},
process=[
/analyze{
action="评估受众和说服背景",
elements=[
"当前立场分析",
"动机和价值映射",
"异议预期",
"影响路径规划"
]
},
/structure{
action="设计说服架构",
approach=[
"吸引注意力的开场",
"建立相关性和可信度",
"建立逻辑和情感案例",
"主动解决异议",
"清晰的行动号召"
]
},
/develop{
action="以战略意图制作说服性内容",
sections=[
/opening{
elements=["钩子", "相关性建立", "论点"],
purpose="吸引注意力和兴趣"
},
/case_building{
structure=[
"逻辑论证进展",
"情感诉求一致性",
"证据呈现",
"利益阐述"
]
},
/objection_handling{
approach="承认、解决和重新框架",
purpose="中和阻力点"
},
/call_to_action{
elements=["具体请求", "紧迫性创建", "后续步骤"],
purpose="推动期望结果"
}
]
},
/enhance{
elements=[
"说服性语言模式",
"社会证明整合",
"视觉说服元素",
"风险缓解框架"
]
},
/finalize{
action="优化说服影响",
checks=["论证连贯性", "情感共鸣", "异议覆盖", "行动清晰度"]
}
],
output={
persuasive_document="旨在推动行动的完整说服性内容",
key_arguments="最有说服力的要点摘要",
objection_responses="对预期阻力的准备答案",
presentation_guidance="有效交付的建议"
}
}实施指南
命题制定:
- 具体说明您要求什么
- 以受众利益而非仅您的需求来框架
- 使其具体和可操作
受众分析:
- 识别对您命题的当前立场
- 理解决策标准和优先事项
- 映射关系和影响动态
动机识别:
- 研究驱动特定受众的因素
- 根据相对重要性确定优先级
- 在可能的情况下以收益而非避免损失来框架
异议预期:
- 列出所有可能的阻力点
- 根据潜在影响确定优先级
- 准备基于证据的回应
性能指标
| 指标 | 描述 | 目标 |
|---|---|---|
| 说服影响 | 改变视角的有效性 | 向期望结果的明显转变 |
| 异议处理 | 解决关注的彻底性 | 所有主要异议被中和 |
| 动机一致 | 与受众驱动因素的联系 | 对关键动机的直接诉求 |
| 行动号召清晰度 | 请求行动的具体性 | 明确的后续步骤 |
6. 政策和程序协议
何时使用此协议: 创建需要全面、一致和可操作的组织治理文档?此协议以清晰和完整性开发政策、程序和标准——非常适合操作指南、合规文档或标准操作程序。
提示:我需要为我们的组织创建全面的远程工作政策,遵循我们混合工作模式的最近变化。此政策需要阐明远程员工的资格、期望、安全要求和绩效衡量。它应该平衡灵活性与问责制,并确保跨部门的一致应用。
协议:
/document.policy{
intent="创建清晰、全面的治理文档",
input={
policy_purpose="为组织定义全面的远程工作政策",
scope="所有符合远程工作安排条件的员工",
stakeholders=["执行领导", "部门经理", "人力资源", "IT", "员工"],
key_components=[
"资格标准和批准流程",
"时间表和可用性要求",
"设备和工作空间标准",
"安全和保密协议",
"绩效衡量和问责制",
"沟通期望"
],
compliance_requirements="数据保护法规、就业法、行业标准",
organizational_context="从办公室优先向混合工作模式过渡"
},
process=[
/structure{
action="建立政策架构",
elements=[
"目的和范围声明",
"关键术语定义",
"按组件的政策声明",
"角色和责任",
"程序和工作流",
"合规和例外",
"相关文档和参考"
]
},
/develop{
action="以精确和清晰度制作政策内容",
sections=[
/purpose_scope{
elements=["政策意图", "适用性", "权威"],
purpose="建立边界和基础"
},
/policy_statements{
for_each="key_component",
structure=[
"清晰的指令声明",
"理由或背景",
"应用指南",
"示例或澄清"
]
},
/procedures{
elements=["分步流程", "决策工作流", "模板"],
purpose="实现一致实施"
},
/roles_responsibilities{
approach="将问责制映射到角色",
purpose="建立所有权和权威"
},
/governance{
elements=["审查周期", "例外处理", "合规监控"],
purpose="确保持续的政策有效性"
}
]
},
/validate{
action="确保政策有效性和合规性",
checks=[
"利益相关者一致性",
"法律/法规合规性",
"实施可行性",
"清晰度和可访问性",
"边缘案例覆盖"
]
},
/finalize{
action="优化可用性和合规性",
elements=[
"一致的格式和术语",
"导航辅助(目录、索引)",
"版本控制和批准",
"实施指导"
]
}
],
output={
complete_policy="包含所有组件的全面政策文档",
implementation_guide="推出政策的指导",
compliance_checklist="监控遵守的关键要求",
communication_materials="向利益相关者解释政策的内容"
}
}实施指南
政策目的定义:
- 清楚地说明正在解决的问题或需求
- 阐述期望的组织结果
- 建立范围和边界
利益相关者识别:
- 包括受政策影响或实施政策的所有方
- 考虑每个群体的视角和需求
- 识别潜在的阻力点
组件定义:
- 将政策分解为逻辑、可管理的部分
- 确保全面覆盖而无重叠
- 根据重要性和影响确定优先级
合规映射:
- 识别所有相关法规和标准
- 注意影响政策的具体要求
- 考虑行业最佳实践
性能指标
| 指标 | 描述 | 目标 |
|---|---|---|
| 清晰度 | 政策声明的可理解性 | 所有利益相关者可访问 |
| 完整性 | 必要组件的覆盖 | 无重大空白 |
| 可实施性 | 将政策付诸实践的便利性 | 清晰、可行的程序 |
| 合规性 | 与要求的一致性 | 完全的法规遵守 |
7. 战略计划协议
何时使用此协议: 开发定义方向和方法的前瞻性文档?此协议创建战略计划、路线图或愿景文档,有效传达方向、优先事项和实施路径——非常适合组织战略、产品路线图或部门计划。
提示:我需要为我们的营销部门制定一个三年战略计划,与公司的全球扩张目标保持一致。该计划应该解决我们向数字优先营销的过渡,在新市场建立我们的能力,并建立衡量框架以展示投资回报率。它需要雄心勃勃但在我们当前的团队规模和预算约束下可实现。
协议:
/document.strategic_plan{
intent="创建前瞻性战略方向文档",
input={
planning_horizon="三年营销部门战略计划",
organizational_context="公司追求数字优先方法的全球扩张",
strategic_objectives=[
"向数字优先营销方法过渡",
"在新地理市场建立营销能力",
"建立全面的衡量框架以展示投资回报率",
"使营销活动与全球扩张目标保持一致"
],
current_state="传统营销组合,数字能力有限,主要关注国内",
resource_constraints="当前团队规模和现有预算,每年适度增加",
success_measures="新地区的市场渗透率、数字参与度指标、营销归因收入"
},
process=[
/analyze{
action="评估战略背景和要求",
elements=[
"环境分析(市场、竞争对手、趋势)",
"能力评估(优势、差距、机会)",
"利益相关者需求和期望",
"与更广泛的组织战略的一致性"
]
},
/structure{
action="设计战略框架",
elements=[
"愿景和使命声明",
"战略支柱或主题",
"目标和关键结果(OKR)",
"分阶段实施方法",
"资源分配框架"
]
},
/develop{
action="以适当的详细程度制作战略内容",
sections=[
/executive_summary{
elements=["战略方向", "关键优先事项", "预期结果"],
purpose="提供战略意图的快速理解"
},
/strategic_framework{
elements=["愿景", "使命", "价值观", "战略支柱"],
purpose="建立基础和边界"
},
/objectives_strategies{
for_each="strategic_objective",
structure=[
"具体目标声明",
"理由和一致性",
"关键战略和方法",
"成功指标和目标"
]
},
/implementation_roadmap{
elements=["分阶段方法", "关键举措", "依赖关系", "里程碑"],
purpose="提供可操作的前进道路"
},
/resource_plan{
elements=["预算要求", "人员配备需求", "能力发展"],
purpose="定义所需投资和分配"
},
/governance_measurement{
elements=["审查节奏", "关键指标", "调整机制"],
purpose="实现进度跟踪和适应"
}
]
},
/validate{
action="测试战略健全性和可行性",
checks=[
"与组织战略的一致性",
"资源可行性",
"风险评估",
"利益相关者支持",
"衡量有效性"
]
},
/finalize{
action="优化灵感和执行",
elements=[
"引人注目的叙述和愿景",
"清晰的问责制分配",
"视觉战略表示",
"高管演示材料"
]
}
],
output={
strategic_plan="具有执行路线图的全面战略文档",
executive_presentation="领导沟通材料",
implementation_framework="详细执行指导",
measurement_dashboard="关键指标和跟踪方法"
}
}实施指南
规划范围定义:
- 为战略类型选择适当的时间框架
- 考虑行业步伐和组织背景
- 在雄心和可预测性之间取得平衡
组织背景评估:
- 记录当前战略方向和优先事项
- 注意相关的市场和竞争因素
- 识别影响战略的关键趋势
战略目标制定:
- 定义3-5个推动成功的主要目标
- 确保目标具体但足够广泛以制定战略
- 验证与组织方向的一致性
当前状态分析:
- 诚实评估当前能力和位置
- 识别要利用的优势和要解决的差距
- 为衡量进展建立清晰的基线
性能指标
| 指标 | 描述 | 目标 |
|---|---|---|
| 战略清晰度 | 方向的可理解性 | 各级清晰的前进道路 |
| 实施可行性 | 执行的实用性 | 现实的资源要求 |
| 衡量框架 | 跟踪进度的能力 | 有目标的有意义指标 |
| 激励质量 | 激励行动的能力 | 引人注目的愿景和叙述 |
8. 综合评估协议
何时使用此协议: 进行需要平衡考虑多个因素的彻底分析?此协议以彻底性和客观性创建评估文档、评估或审查——非常适合绩效评审、情况分析、项目评估或产品评估。
提示:我需要对我们最近完成的软件实施项目进行全面评估。我们需要评估什么进展顺利,我们面临什么挑战,交付成果的最终质量,并提取未来项目的关键教训。这应该是平衡和客观的,承认成功和改进领域。
协议:
/document.assessment{
intent="创建平衡、彻底的评估文档",
input={
assessment_subject="最近完成的软件实施项目",
evaluation_dimensions=[
"项目管理有效性",
"交付成果质量和完整性",
"预算和时间线绩效",
"利益相关者满意度",
"团队绩效和协作",
"风险管理有效性"
],
assessment_purpose="项目后审查以提取教训并改进未来实施",
data_sources="项目文档、利益相关者访谈、质量指标、预算报告",
intended_audience="项目领导、执行发起人、实施团队",
balance_requirement="对成功和改进机会的同等关注"
},
process=[
/structure{
action="设计全面的评估框架",
elements=[
"带平衡亮点的执行摘要",
"评估方法和方法",
"维度评估",
"综合发现和模式",
"建议和行动项",
"支持证据和数据"
]
},
/gather{
action="收集和组织评估输入",
approach=[
"三角化多个数据源",
"应用一致的评估标准",
"识别模式和异常值",
"保持客观性和证据基础"
]
},
/analyze{
action="以深度和平衡评估评估维度",
for_each="evaluation_dimension",
structure=[
/dimension_assessment{
elements=[
"发现的客观描述",
"优势识别",
"挑战或差距分析",
"贡献因素探索",
"证据和示例"
]
},
/rating_and_context{
elements=["定量/定性评级", "与标准或期望的比较"],
purpose="提供清晰的绩效指示"
}
]
},
/synthesize{
action="开发综合见解和建议",
elements=[
"跨维度模式",
"根本原因识别",
"具体、可操作的建议",
"优先级框架",
"实施指导"
]
},
/finalize{
action="优化客观性和效用",
checks=[
"证据力度",
"平衡和公平",
"建议的可操作性",
"呈现的清晰度",
"与评估目的的一致性"
]
}
],
output={
assessment_report="具有平衡发现的全面评估",
executive_summary="关键发现和建议的简明概述",
recommendation_roadmap="优先改进行动",
lessons_learned="未来应用的关键见解"
}
}实施指南
评估主题定义:
- 清楚地定义范围和边界
- 指定评估的时间段或版本
- 注意任何特殊的背景因素
维度选择:
- 选择4-7个关键评估方面
- 确保维度涵盖所有关键因素
- 平衡过程和结果维度
目的阐明:
- 定义此评估将告知的具体决策
- 识别如何使用发现
- 考虑可操作性的时间需求
数据源识别:
- 列出所有可用的信息源
- 包括定量和定性数据
- 注意任何重要的数据限制
性能指标
| 指标 | 描述 | 目标 |
|---|---|---|
| 客观性 | 平衡和基于证据的分析 | 无未经证实的判断 |
| 全面性 | 所有关键维度的覆盖 | 无重大盲点 |
| 洞察质量 | 发现的深度和有用性 | 揭示不明显的模式 |
| 可操作性 | 建议的实用性 | 具体、可行的改进路径 |
高级协议集成
为复杂项目组合文档协议
对于复杂的文档需求,协议可以组合或嵌套:
提示:我需要为重大数字化转型计划创建全面的业务案例,既包括说服性元素以获得高管批准,又包括实施的详细战略规划。它需要说服我们的领导团队批准500万美元的投资,同时还提供执行三年计划的清晰路线图。
协议:
/document.integrated{
components=[
/document.persuasive{
intent="获得数字化转型投资的高管批准",
input={
proposition="批准500万美元用于全面数字化转型的投资",
target_audience="关注增长和运营效率的C级高管",
desired_outcome="全额资金批准和高管发起",
key_motivators=[
"运营效率提高30%",
"新数字收入流(15%增长预测)",
"快速发展市场中的竞争差异化",
"数字颠覆威胁的风险缓解"
],
potential_objections=[
"投资回报率时间表超过典型投资标准",
"重大变革管理挑战",
"以前的技术投资表现不佳"
],
evidence_available="市场分析、竞争对手基准测试、试点项目结果、客户反馈"
},
// 过程和输出细节
},
/document.strategic_plan{
intent="为转型计划提供实施路线图",
input={
planning_horizon="三年数字化转型计划",
organizational_context="面临数字颠覆压力的传统公司",
strategic_objectives=[
"现代化核心技术基础设施",
"数字化面向客户的流程和接触点",
"建立数据分析能力和文化",
"开发数字产品创新管道"
],
current_state="遗留系统、孤立数据、传统流程",
resource_constraints="有限的数字人才、竞争优先事项",
success_measures="效率指标、数字收入、客户满意度"
},
// 过程和输出细节
}
],
integration_framework={
structure="带战略实施细节的说服性执行摘要",
alignment="确保跨组件的一致消息传递和数据",
progression="以说服性案例引领,过渡到战略执行"
}
}协议适应指南
添加专业化处理步骤:
/document.technical{ ... process=[ ..., /specialized{action="领域特定技术验证"} ] }扩展输入参数:
/document.strategic_plan{ ... input={ ..., competitive_landscape="[详细竞争对手分析]" } }增强输出规范:
/document.assessment{ ... output={ ..., maturity_model="[能力成熟度框架]" } }
性能优化技巧
Token效率
内容优先级排序:
- 专注于影响最大的文档元素
- 对详细信息使用渐进式披露
- 在关键领域偏好深度而非所有领域的广度
流程精简:
- 对于简单文档,降低流程复杂性
- 组合相关开发步骤
- 删除已充分理解格式的验证步骤
输出焦点:
- 只请求需要的文档组件
- 匹配实际使用要求的详细级别
- 使用结构化格式进行高效信息呈现
文档协议的场域动力学
对于高级文档开发,融入场域动力学:
提示:我需要创建一个战略愿景文档,激励我们的组织接受我们处理客户体验方式的重大转型。此文档应在客户中心性周围建立强大的吸引子,同时允许在我们实施愿景时进行适应。
协议:
/document.strategic_plan{
...
field_dynamics={
attractors: [
"以客户为中心的思维",
"持续改进文化",
"数据驱动的决策制定"
],
boundaries: {
firm: ["短期财务关注", "部门孤岛"],
permeable: ["实施方法", "技术选择"]
},
resonance: ["对客户需求的同理心", "创新思维"],
residue: {
target: "客户体验是每个人的责任",
persistence: "高"
}
},
...
}文档协议库管理
随着文档协议集合的增长,组织它们对于重用和改进变得至关重要。
组织框架
创建个人文档协议库:
markdown
# 文档协议库
## 按文档类型
- [战略计划 v2.1](#strategic-plan)
- [说服性提案 v1.3](#persuasive-proposal)
- [技术文档 v3.0](#technical-documentation)
## 按使用背景
- [高管沟通](#executive-communication)
- [团队文档](#team-documentation)
- [外部发布](#external-publishing)
## 协议定义
### 战略计划/document.strategic_plan.v2.1{ // 完整协议定义 }
### 说服性提案/document.persuasive.v1.3{ // 完整协议定义 }
文档协议开发过程
创建您自己的文档协议遵循此开发路径:
┌─────────────────────────────────────────────────────┐
│ │
│ 文档协议开发周期 │
│ │
│ 1. 识别需求 │
│ • 识别重复的文档类型 │
│ • 识别创作过程中的痛点 │
│ • 定义质量标准和成功标准 │
│ │
│ 2. 设计结构 │
│ • 定义文档组件和架构 │
│ • 概述开发过程步骤 │
│ • 确定所需输入参数 │
│ │
│ 3. 原型和测试 │
│ • 创建最小可行协议 │
│ • 使用现实文档需求测试 │
│ • 记录性能和挑战 │
│ │
│ 4. 优化和完善 │
│ • 基于测试结果增强 │
│ • 优化效率和质量 │
│ • 提高可用性和灵活性 │
│ │
│ 5. 标准化和分享 │
│ • 创建使用指南 │
│ • 定义性能指标 │
│ • 添加到组织协议库 │
│ │
└─────────────────────────────────────────────────────┘结论:文档创作的演变
文档协议代表了传统内容创作方法的范式转变。通过为文档开发提供明确的架构和流程,它们将不可预测、费力密集的写作转变为结构化、可靠的内容生产。
在构建文档协议库时,请记住这些原则:
- 从高价值文档开始:专注于经常创建或关键的文档类型
- 基于结果迭代:基于实际使用结果优化协议
- 分享和标准化:为一致质量创建组织标准
- 以系统思考:考虑文档如何在更大的沟通生态系统中协同工作
- 平衡结构和创造力:提供足够的结构以保持一致性,同时允许适当的灵活性
有了这些原则和本指南中的文档协议,您已经具备了将内容创作从不可预测、费力密集的工作转变为可靠、高效的高质量文档生产的充分准备。
反思性问题:这些文档协议如何改变您在组织内的知识捕获和沟通方法?
"写作的过程就是思考的过程。清晰的文档反映清晰的思考,清晰的协议创建清晰的文档。"
附录:快速参考
协议基本结构
/document.type{
intent="清晰的目的陈述",
input={...},
process=[...],
output={...}
}常见处理动作
/structure:定义文档架构/develop:遵循结构创建内容/analyze:检查信息或背景/validate:验证质量或准确性/enhance:添加提高影响的元素/finalize:优化最终交付
文档协议选择指南
| 需求 | 推荐协议 |
|---|---|
| 创建全面文章 | /document.article |
| 开发技术文档 | /document.technical |
| 编写高管简报 | /document.executive_brief |
| 创建以学习为重点的内容 | /document.instructional |
| 开发说服性文档 | /document.persuasive |
| 创建政策或程序 | /document.policy |
| 开发战略计划 | /document.strategic_plan |
| 进行全面评估 | /document.assessment |