# Project Design Concept Organizer

> 补充 doc-todo-log-loop，在开发过程中归纳项目的设计理念和架构模式，将开发决策和隐性知识转化为系统的设计文档

- **Type:** Skill
- **Install:** `agentstack add skill-cafe3310-public-agent-skills-project-design-concept-organizer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cafe3310](https://agentstack.voostack.com/s/cafe3310)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [cafe3310](https://github.com/cafe3310)
- **Source:** https://github.com/cafe3310/public-agent-skills/tree/main/skills/project-design-concept-organizer

## Install

```sh
agentstack add skill-cafe3310-public-agent-skills-project-design-concept-organizer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 项目设计与概念整理 (Project Design & Concept Organizer)

## 1. 简介 (Introduction)

这是一个用于**梳理和沉淀**项目知识的技能。

在项目开发过程中，我们会自然形成许多设计模式、约定俗成的协议或特定的架构选择。此技能的目标是回顾：从已有的代码和讨论中提炼出这些设计要素，并将其整理为清晰的文档。它帮助我们保持项目概念的一致性，并方便新成员（或未来的自己）理解系统的全貌。

## 2. 适用场景 (When to Use)

请在以下情况使用本技能：

1.  **阶段性梳理**: 完成了一个较大的功能模块，需要总结其设计思路时。
2.  **模式固化**: 发现代码中反复出现某种特定的交互方式（如特定的前后端通信协议），需要将其正式定义时。
3.  **补充开发日志**: 在记录开发日志（`doc-todo-log-loop`）后，发现本次更新包含了重要的架构决策，值得单独提取出来时。
4.  **理清思路**: 当项目变得复杂，需要重新审视整体结构或目录规划时。

## 3. 操作步骤

### 第一步：回顾与识别 (Review & Identify)
回顾近期的代码变更、文件结构调整或关键的对话记录。
思考以下问题：
*   我们最近解决了什么核心问题？是用什么思路解决的？
*   代码中是否涌现出了新的“标准做法”或“协议”？
*   目录结构是否有明确的层级划分意图？

### 第二步：提炼概念 (Extract Concepts)
将具体的实现细节抽象为通用的设计概念。注意，宁缺毋滥，切勿过分抽象或过度提炼。
*   *示例*: 从一系列“修改了的文件”，提炼出“引入了配置驱动的插件机制”。
*   *示例*: 从一系列“前端加了某个判断”，提炼出“定义了基于特定标记的流式渲染协议”。

### 第三步：文档化 (Document)
使用下方的模板，创建或更新项目的设计文档（通常存放在 `docs/` 或根目录下，如 `ARCHITECTURE.md` 或 `DESIGN_CONCEPTS.md`）。
*   保持语言平实、准确。
*   记录“为什么这么做”以及“如何运作”。

## 4. 整理模板 (Template)

在整理设计文档时，请参考以下结构。你可以根据实际情况灵活调整。

```markdown
# [项目/模块名称] 设计理念与架构规范

## 1. 核心理念 (Core Philosophy)
> 简述项目的核心设计原则。不仅仅是“做什么”，更重要的是“为什么这么做”。
*   **原则 1**: [例如：文档驱动开发] - [简短解释]
*   **原则 2**: [例如：UI 与逻辑分离] - [简短解释]

## 2. 关键概念 (Key Concepts)
> 定义项目中特定的术语、模型或隐喻。
*   **[概念名]**: [解释。例如：“Inbox 范式” - 所有输入先进入 Inbox 目录等待分拣。]
*   **[概念名]**: [解释。例如：“Agent 节点” - 图谱中的独立执行单元。]

## 3. 交互协议 (Interaction Protocols)
> 记录前后端交互、组件间通信的特定规则。
*   **协议名称**: [例如：标记流式协议]
    *   **机制**: [描述协议如何工作]
    *   **目的**: [解决了什么问题]

## 4. 架构与目录意图 (Architecture & Directory Intent)
> 解释核心目录或模块的设计意图。
*   `app/core`: [存放核心业务逻辑，不依赖具体 UI]
*   `components/ui`: [纯展示组件，无业务状态]
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cafe3310](https://github.com/cafe3310)
- **Source:** [cafe3310/public-agent-skills](https://github.com/cafe3310/public-agent-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cafe3310-public-agent-skills-project-design-concept-organizer
- Seller: https://agentstack.voostack.com/s/cafe3310
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.