persona-aware-coding

身份感知编码 (Persona-Aware Coding)

1. 概述

同一个功能，由不同风格的工程师实现，会产生截然不同的代码。本技能读取 Hermes Agent 的 SOUL.md 文件（Agent 的人设定义文件），在代码生成的每一个环节动态适配风格、语气和架构决策，使产出的代码真正 "像这个人写的"，而非 "像 AI 写的"。

这是 hermes-agent-skills 相对于通用 agent-skills 项目的核心差异化能力——Hermes Agent 有原生的身份系统，本技能将其应用到代码生成全流程。

2. 核心流程

2.1 SOUL.md 解析与映射

# ~/.hermes/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 工具链集成

# 检查 SOUL.md 是否存在
read_file("~/.hermes/SOUL.md")

# 如果不存在，引导用户创建
# 使用 clarify 工具询问人设偏好
clarify(
    question="你希望我以什么风格编写代码？",
    choices=[
        "严谨架构师 — 类型安全、显式错误处理、分层架构",
        "敏捷实干家 — 实用主义、够用就好、快速迭代",
        "极简黑客 — 最少代码、最大效果、不废话",
        "教学导师 — 详细注释、解释设计决策、可读性优先"
    ]
)

# 加载身份感知技能
/skill persona-aware-coding

# 可通过记忆持久化人设偏好
memory(action="add", target="user", content="编码风格偏好: 严谨架构师型")