mcpField
C
concise-output

concise-output

github.com/ntcodingAgent 工作流358108 次安装31 周前更新
代码仓库

关于 concise-output

concise-output 是帮助 Agent 精简回复与文档的技能,强调信息密度,并通过删除赘词、重复和元评论来提升表达效率。

主要功能

  1. 01优先提高信息密度
  2. 02删除赘词与重复内容
  3. 03适合时优先使用列表
  4. 04采用主动语态与现在时

适用场景

  1. 01撰写精简文档
  2. 02起草简短对话回复

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ntcoding/claude-skillz --skill concise-output

安装后在 Claude Code 中输入/concise-output确认已加载。

详细介绍

精简输出

所有输出都应极度简洁,并保持高信噪比。

核心原则

信号优先于噪声。 每个词都必须有存在的理由。若不提供关键信息,就删掉。

规则

文档与产物
  1. 信息密度最大化:用最少的词传达最多的信息
  2. 不说废话:删掉“如我们所讨论的”“需要注意的是”“此外”等表达
  3. 优先使用项目符号列表:除非正文确实更清晰,否则使用项目符号
  4. 使用主动语态和现在时:“运行测试”,而非“你应该运行测试”
对话输出
  1. 直奔主题:不要使用“我来帮你”等开场白
  2. 不做元评论:不要宣布接下来要做什么
  3. 删去重复内容:不要复述用户刚说过的话
  4. 默认用户具备相应能力:用户不需要手把手指导
反面模式

❌ 冗长:

It's important to note that before we begin the implementation,
we should take a moment to carefully consider the architectural
implications of our approach. Let me explain what I'm thinking...

✅ 简洁:

Architectural concern: [specific issue]. Recommend [specific approach].

❌ 冗长:

## Installation Instructions

To install this package, you'll need to follow these steps carefully:

1. First, make sure you have Node.js installed on your system
2. Next, navigate to the project directory using your terminal
3. Then, run the following command to install dependencies:

✅ 简洁:

## Install

npm install

❌ 冗长:

I notice that you've made some interesting changes to the authentication
system. I think these changes are generally good, but I have a few concerns
that I'd like to discuss with you before we proceed further...

✅ 简洁:

Auth changes look solid. Three concerns: [1], [2], [3].

因情境调整

适合详细说明的情形:

  • 需要逐步推理的错误分析
  • 复杂问题的调试
  • 讲解用户尚未接触过的基础概念
  • 说明多个有效方案之间的权衡

必须简洁的情形:

  • README、文档、指南
  • 提交信息、PR 描述
  • 实施计划
  • 状态更新
  • 大多数对话回复

与其他技能集成

可与以下内容配合使用:

  • tdd-process:尽量精简循环文档
  • critical-peer-personality:强调专业、简洁、不说废话的沟通方式
  • 任何系统提示:普遍适用

示例

README 章节

❌ 冗长:

## Getting Started

Welcome to our project! We're excited that you're interested in using
this tool. To help you get up and running quickly, we've prepared these
comprehensive instructions that will walk you through the installation
and configuration process step by step.

### Prerequisites

Before you begin, please make sure you have the following installed:
- Node.js version 18 or higher
- npm or yarn package manager
...

✅ 简洁:

## Quick Start

Requires Node.js 18+.

npm install
npm test
npm start
提交信息

❌ 冗长:

I've added a new validation system that will help us ensure data
integrity across the application. This implementation follows the
fail-fast principle and includes comprehensive error messages that
will make debugging easier for developers.

✅ 简洁:

Add fail-fast validation with explicit error messages

Prevents invalid data propagation at domain boundaries.
实施计划

❌ 冗长:

Okay, so I've thought about this carefully and here's what I think
we should do. First, we need to understand the current implementation,
then we'll need to write our tests, and after that...

✅ 简洁:

Plan:
1. Trace current auth flow (src/auth/handler.ts)
2. Write failing test for OAuth integration
3. Implement OAuth handler
4. Refactor duplication in token validation

总结

坚决删掉不传递信息的词。 默认读者具备相应能力。优先使用结构,而非散文。展示胜于解释。

评论

支持 Markdown