| name | persona-aware-coding |
| description | Use before starting any code generation task. Reads Hermes Agent's SOUL.md to dynamically adapt code style, comment tone, documentation voice, and architectural decisions to match the agent's defined persona. |
| triggers | ["persona","人设","soul","character","角色","style","风格","tone","语气","who am I","identity","我是谁"] |
| version | 1.0.0 |
| author | Ow1onp |
身份感知编码 (Persona-Aware Coding)
1. 概述
同一个功能，由不同风格的工程师实现，会产生截然不同的代码。本技能读取 Hermes Agent 的 SOUL.md 文件（Agent 的人设定义文件），在代码生成的每一个环节动态适配风格、语气和架构决策，使产出的代码真正 "像这个人写的"，而非 "像 AI 写的"。
这是 hermes-agent-skills 相对于通用 agent-skills 项目的核心差异化能力——Hermes Agent 有原生的身份系统，本技能将其应用到代码生成全流程。
2. 核心流程
2.1 SOUL.md 解析与映射
name: "严谨架构师"
traits:
- 偏好显式优于隐式
- 重视错误处理
- 代码即文档
coding_style:
naming: snake_case
max_line_length: 100
prefer: [type_hints, dataclasses, dependency_injection]
avoid: [magic_numbers, global_state, premature_optimization]
comment_style: "解释为什么，不解释做什么"
test_style: "describe/it 风格"
architecture_preference: "分层架构 + 依赖注入"
2.2 代码生成全流程适配
┌───────────────────────────────────────────────────────┐
│ SOUL.md 驱动的代码生成流水线 │
├───────────────┬───────────────────────────────────────┤
│ 命名风格 │ SOUL.naming → snake_case / camelCase │
│ 类型系统 │ SOUL.type_hints → 是否使用类型标注 │
│ 错误处理 │ SOUL.error_style → try/except / Result│
│ 注释密度 │ SOUL.comment_density → 稀疏 / 详细 │
│ 注释语气 │ SOUL.tone → 正式 / 口语 / 技术极客 │
│ 架构模式 │ SOUL.architecture → 分层 / 六边形 / MVC│
│ 测试风格 │ SOUL.test_style → describe/it / test_ │
│ 提交信息 │ SOUL.commit_style → 规范 / 简洁 │
└───────────────┴───────────────────────────────────────┘
2.3 风格适配示例
场景: 写一个用户认证中间件
| 维度 | "严谨架构师" 风格 | "极简黑客" 风格 | "教学导师" 风格 |
|---|
| 命名 | authenticate_user() | auth() | check_if_user_is_logged_in() |
| 类型 | 完整 type hints | 无类型标注 | 关键处有标注 + 注释 |
| 错误 | 自定义异常类 | return None | 详细错误消息 + 建议 |
| 注释 | 无（代码自解释） | 无 | 行内解释设计决策 |
| 文档 | 完整 docstring | 无 | 教程式文档 + 示例 |
2.4 Hermes 工具链集成
read_file("~/.hermes/SOUL.md")
clarify(
question="你希望我以什么风格编写代码？",
choices=[
"严谨架构师 — 类型安全、显式错误处理、分层架构",
"敏捷实干家 — 实用主义、够用就好、快速迭代",
"极简黑客 — 最少代码、最大效果、不废话",
"教学导师 — 详细注释、解释设计决策、可读性优先"
]
)
/skill persona-aware-coding
memory(action="add", target="user", content="编码风格偏好: 严谨架构师型")
2.5 自进化机制
- 风格一致性评分：分析最近 N 次代码生成，检查风格是否与 SOUL.md 一致
- 人设漂移检测：如果用户的代码风格在变化，建议更新 SOUL.md
- 最佳实践融合：当 SOUL 偏好与社区最佳实践冲突时，提出平衡建议
- 跨项目风格学习：用户在多个项目中的编码习惯自动归纳到 SOUL.md
2.6 身份感知
本技能自身也受 SOUL.md 影响——它是一个 "自指" 技能：
- 如果 SOUL.md 定义 Agent 为 "严谨型" → 本技能的输出更系统化
- 如果 SOUL.md 定义 Agent 为 "创意型" → 本技能允许更多风格实验
- 如果 SOUL.md 不存在 → 使用中性默认值，并提示用户创建
3. 门禁标准
4. 常见逃避借口与反驳
| 借口 | 反驳 |
|---|
| "代码风格不重要，能跑就行" | 代码是写给人看的，只是顺便让机器执行。风格不一致的代码库是认知负荷的地狱。 |
| "我没有 SOUL.md，就用默认的" | 没有 SOUL 的 Agent 就像没有性格的演员——能表演，但没有灵魂。花 3 分钟定义它。 |
| "AI 写的代码风格都一样，改不了" | 这正是本技能存在的意义。AI 可以模仿任何风格，只需要明确的指令——SOUL.md 就是那个指令。 |
| "风格一致性是小事" | 在 10 万行代码库里，风格不一致不是小事——它让你每次打开新文件都要重新适应。 |
| "不同项目应该用不同风格" | 正确！SOUL.md 支持项目级覆盖（SOUL.md 放在项目根目录而非 ~/.hermes/）。 |
