setup-james-skills

设置 James Skills

仅协调当前仓库根目录下的 AGENTS.md，让编码 Agent 能发现：

• tech-preferences — 首选、实验性和避免使用的技术；
• engineering-principles — 以便于本地推理为目标进行设计；
• verifiable-trust — 独立验证和受限的 AI 自主性。

这是一个会修改文件的设置技能。明确调用即授权在限定范围内修改 AGENTS.md，但不授权修改其他仓库、安装技能或进行无关重构。

协调流程

1. 确定仓库根目录，并在 AGENTS.md 存在时读取它。检查现有引用和已记录的项目例外；保留仓库专属说明及无关内容。
2. 检查当前 Agent 环境是否已安装/可发现全部三项技能。报告缺少的技能；不得声称已安装，也不得在未说明的情况下安装。仍可写入引用，以便后续设置。
3. 查找准确的标记对 和。如果两者都按正确顺序各出现恰好一次，则仅在需要时将该托管块的内容替换为下方的规范块。如果标记不完整、重复或格式错误，应保留文件并报告歧义，不要猜测。
4. 如果不存在托管块，查找是否有等效的现有个人指导章节。如果能明确判断，则在原处更新该章节，以避免重复。否则，空行分隔后追加规范块；若根目录下没有 AGENTS.md，则创建它。
5. 保持所有无关说明不变；避免重新格式化整个文件。遵循仓库的换行符惯例，并确保文件以换行符结尾。
6. 重新读取并比较差异。确认只有一个托管块，且三项技能的引用在该块内各出现一次，并包含实施前阅读其完整内容以及将此要求传达给工作者的说明。重复运行不得产生任何更改。报告文件是新建、已更新还是原本正确，以及是否有技能不可用。

规范托管块

复制以下准确内容，包括标记：

## Personal engineering guidance

These skills are **standing constraints**, not alternatives to Matt Pocock's workflow. **Before implementing or changing code** (including through `/implement`, `/implement-spec`, `/tdd` or direct implementation), read the full installed content of all three:

- **`tech-preferences`** — Preferred technologies, exclusions and rules for existing architecture decisions.
- **`engineering-principles`** — Local reasoning, cohesive capabilities, clear boundaries and explicit dependencies.
- **`verifiable-trust`** — Independent verification, bounded authority and recoverability.

Apply their guidance throughout implementation and review. **Skill availability or a reference here does not mean the agent has read the skill.** Read each once per task, not at every test cycle; for trivial documentation-only work, apply guidance proportionately.

When delegating implementation, explicitly require each worker to read and apply these skills in its own context. Don't assume the parent's loaded skill content is inherited. If a skill is unavailable, say so rather than silently proceeding as if it were applied.

Documented project decisions take precedence over generic defaults. Flag meaningful deviations **before implementing**, recommend an approach and ask before changing established technology. When James chooses to retain a deviation, record the decision and don't reopen it without a request or material new evidence.

Source: [jamespegg/skills](https://github.com/jamespegg/skills).

边界

• 引用应简洁；不要将技能正文复制到 AGENTS.md。技能仓库是其内容的权威来源。
• 保留项目策略、现有决策、嵌套的 AGENTS.md 文件、应用代码、工作流和依赖项。
• 仅修改明确指定范围内的仓库。如果有文档记录的决定明确排除这些引用，不要覆盖，应先讨论这一冲突。
• 在 AGENTS.md 中提及某项技能，本身并不会安装、加载或保证调用该技能。如果 Agent 环境无法发现该技能，请如实说明。