文档写作与改进
帮助组织一套文档、写好一篇文档,并清楚表达段落与句子。适用于说明、方案、记录、操作手册、Skill 及其参考资料。
三个层面相互支撑:整体组织确定文档之间的分工与关系,单篇结构服务其职责,段落和句子传达具体意思。按当前问题进入相应层面;局部问题来自上层时,先调整上层组织。
按需要读取
编写、修改或评审文档时先读文档写作原则,再按产物选择模板。
| 当前需要 | 读取 |
|---|---|
| 规划文档体系、划分职责或理清阅读路径 | 文档体系的组织 |
| 确定单篇内容、结构与展开顺序 | 单篇文档的写作 |
| 改进段落、句子和要求的表达 | 段落与句子的表达 |
| 整合反馈、评审可用性与核对改动 | 修改与检查 |
| 编写可复用的指导性参考文档 | 参考文档模板 |
能力边界
本 Skill 负责文档的组织、表达与可用性。产品、工程和 Agent 的专业判断由相应领域能力负责;Skill 的能力定位、发现与调用机制、行为验证由 agent-design 负责,文档写法遵循本 Skill。
普通对话不要求套用完整文档规范。