# Cognitive Atom Architecture

> All original reference files, templates, and scripts should be intact at `~/.hermes/skills/cognitive

- Skill: `yakeworld/cognitive-atom-architecture` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add yakeworld/cognitive-atom-architecture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yakeworld/cognitive-atom-architecture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: yakeworld (https://skillmd.com/u/yakeworld)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/yakeworld/cognitive-atom-architecture

---


## Reference Files (intact — see linked_files)

All original reference files, templates, and scripts should be intact at `~/.hermes/skills/cognitive-atom-architecture/references/`. See `skill_view('cognitive-atom-architecture', file_path=...)` to access individual references.

## IO_CONTRACT

- **input**: `philosophical_framework: md` — 7+1 东西融合哲学框架（`references/philosophical-foundations.md` 及各维度定义）
- **input**: `target_skill: SKILL.md` — 待追溯工程约束的原子技能文件（`skills/` 下各原子）
- **output**: `engineering_constraints` — 按 5 步流程（extract→trace→classify→fix→verify）从哲学约束追溯到原子技能的可执行约束
- **output**: `references/` — 完整参考文件集（philosophical-foundations / synthos-dimension-guide / 验证与融合 pattern，v4.0.0 四件套）

## 原则 (Principles)

- **哲必可溯**：哲学框架须经 extract→trace→classify→fix→verify 五步，追溯为原子技能可执行之工程约束；仅悬于理而无迹可寻者，为形不为例。
- **七维一体**：7+1 框架各维须有定义、有度量法、有原子映射，缺一维则框架失其整。
- **示例独立**：每一示例必可独立运行、输入输出明确、含边界与错误处理，否则不足以证其法。
- **原件无损**：`references/` 四件套（philosophical-foundations / dimension-guide / 验证 pattern / 融合 pattern）须完整无损，原件失则法无据。

## Genes (策略基因)

> 紧凑策略表示。条件→策略。需要深度时参考完整文档。

- **[COGN-001]** 哲学框架需转化为工程约束 → 执行 extract→trace→classify→fix→verify 五步追溯流程，确保每条哲学约束映射为原子技能中可执行的具体约束
- **[COGN-002]** 构建 7+1 融合哲学框架 → 确保每一维度均具备明确定义、度量方法及原子映射，缺一维则判定框架失整并中止追溯
- **[COGN-003]** 设计技能示例 → 保证每个示例可独立运行，明确输入输出，并强制包含边界用例与错误处理场景以证其法
- **[COGN-004]** 管理参考文件资产 → 保持 `references/` 下四件套（哲学基础、维度指南、验证模式、融合模式）完整无损，原件缺失则拒绝产出
- **[COGN-005]** 处理输入参数 → 严格校验参数类型、范围及格式，不符合约束的操作视为不安全并予以拒绝或隔离
- **[COGN-006]** 定义输出规范 → 确保返回值结构、编码及命名保持一致，且错误信息必须包含上下文与恢复建议
- **[COGN-007]** 执行安全边界控制 → 禁止执行未验证的任意代码，严禁暴露内部状态，违反规则的操作必须被隔离

## 示例 · EXAMPLES

1. **基本用法**: 标准输入 → 标准输出
2. **边界用例**: 空输入、特殊字符、异常路径
3. **错误场景**: 缺失依赖、权限不足、网络异常

## 约束规则 · RULES

1. **输入约束**: 参数类型、范围、格式必须校验
2. **输出约束**: 返回值结构、编码、命名必须一致
3. **异常约束**: 错误信息必须包含上下文和恢复建议
4. **安全约束**: 不执行未验证的任意代码，不暴露内部状态

> 违反规则的操作视为不安全，必须拒绝或隔离。

> 每个示例必须可独立运行、有明确输入输出、包含错误处理。

**Session additions (2026-05-23):**
- `east-west-syncretism-pattern.md` — Methodology for merging Eastern ontology with Western epistemology into a single 7+1 framework. 4-step synthesis, per-dimension mapping table, known pitfalls.
- `philosophy-engineering-verification-pattern.md` — Methodology for verifying that a philosophical framework produces actionable engineering constraints in atomic skills. 5-step flow: extract→trace→classify→fix→verify.

Key reference files added in v4.0.0:
- `references/philosophical-foundations.md` — full 7+1 Syncretic Framework with per-dimension definitions and engineering constraints
- `references/synthos-dimension-guide.md` — per-dimension evaluation methods and atomic mappings
- `references/philosophy-engineering-verification-pattern.md` — methodology for tracing philosophical constraints through atomic skills (2026-05-23)
- `references/east-west-syncretism-pattern.md` — pattern for merging Eastern and Western philosophical concepts into unified engineering constraints

# Cognitive Atom Architecture---

## Golden 集合 · GOLDEN SET

- **Golden Input**: `philosophical_framework: references/philosophical-foundations.md`（7+1 框架）, `target_skill: skills/core/knowledge-extraction/SKILL.md`
- **Golden Output**: 按 extract→trace→classify→fix→verify 五步产出 `engineering_constraints`——每条哲学约束映射到目标技能的 1 条可执行工程约束（含位置与措辞）
- **Golden Error**: 7+1 框架缺一维（无定义/无度量法/无原子映射）→ 框架失整，追溯中止；references/ 四件套缺件 → "原件无损"不成立，拒绝产出

> (P032 去重: 保留另一份 5 行独有内容)
## 验证清单 (Verification)
- [ ] `~/.hermes/skills/cognitive-atom-architecture/references/` 下原始参考文件、模板、脚本完整无损（v4.0.0 四件套齐全）
- [ ] 哲学框架按 5 步流程（extract→trace→classify→fix→verify）在原子技能中追溯出可执行的工程约束
- [ ] 每个示例可独立运行、输入输出明确、含错误处理（边界/错误场景各一）
- [ ] 违反约束规则的操作被拒绝或隔离，未暴露内部状态