add-feature

分类: 工具与效率 | 上传者: tomcounsell | 下载: 0 | 版本: v1.0（最新）

在向 Valor 系统添加新功能、技能、工具或 MCP 服务器时使用。由“添加功能”、“创建新工具”、“扩展系统”或“如何添加...”触发。

更新日志: Source: GitHub https://github.com/tomcounsell/ai

目录结构

当前层级: tree/main/.claude/skills/add-feature/

📄 SKILL.md 4.4 KB

SKILL.md

---
name: add-feature
description: "Use when adding a new feature, skill, tool, or MCP server to the Valor system. Triggered by 'add a feature', 'create a new tool', 'extend the system', or 'how do I add...'."
argument-hint: "<feature-name> or description"
---

# Add Feature - Extension Guide

How to extend the Valor system with new capabilities.

## When to Use

- Adding a Claude Code skill (slash command)
- Adding to the Telegram bridge
- Creating new Python tools
- Adding new documentation

## Adding a Claude Code Skill

Skills live in `.claude/skills/<skill>/SKILL.md`:

```markdown
---
name: skill-name
description: "Use when [trigger condition]. Also use when [secondary trigger]."
allowed-tools: Read, Write, Edit, Bash
---

# Skill Name

## What this skill does
Description of what this skill does.

## When to load sub-files
- [Condition A] -> read [SUB_FILE_A.md](SUB_FILE_A.md)

## Quick start
Step-by-step instructions for the most common use of this skill.
```

### Examples (in `.claude/skills/`)

- `prime/SKILL.md` - Codebase onboarding
- `pthread/SKILL.md` - Parallel thread execution
- `sdlc/SKILL.md` - Autonomous dev workflow
- `do-pr-review/SKILL.md` - PR review and implementation validation
- `setup/SKILL.md` - New machine configuration

## Adding to the Telegram Bridge

The bridge is in `bridge/telegram_bridge.py`.

### Adding Message Handling

1. Add pattern matching in the message handler:

```python
async def handle_message(self, event):
    text = event.message.text

    # Add your pattern
    if text.startswith('/mycommand'):
        return await self.handle_my_command(event)
```

2. Implement the handler:

```python
async def handle_my_command(self, event):
    # Extract arguments
    args = event.message.text.split()[1:]

    # Process and respond
    result = do_something(args)
    await event.reply(result)
```

3. Restart the bridge after changes:

```bash
./scripts/valor-service.sh restart
```

## Adding Python Tools

Local tools live in `tools/<tool_name>/`.

### Structure

```
tools/my_tool/
├── __init__.py       # Exports main functions
├── core.py           # Core implementation
├── cli.py            # Optional CLI interface
└── README.md         # Documentation
```

### Example __init__.py

```python
from .core import my_function, MyClass

__all__ = ['my_function', 'MyClass']
```

### Adding CLI

```python
# tools/my_tool/cli.py
import argparse

def main():
    parser = argparse.ArgumentParser(description='My tool')
    parser.add_argument('action', choices=['do', 'list'])
    args = parser.parse_args()

    if args.action == 'do':
        from .core import my_function
        result = my_function()
        print(result)

if __name__ == '__main__':
    main()
```

Register in `pyproject.toml`:

```toml
[project.scripts]
my-tool = "tools.my_tool.cli:main"
```

Then install: `uv pip install -e .`

## Adding Documentation

### Where to Put It

| Content Type | Location |
|--------------|----------|
| Development workflow | `CLAUDE.md` (if essential) |
| Feature documentation | `docs/features/<name>.md` |
| Architecture details | `docs/architecture/<name>.md` |
| Operations guides | `docs/operations/<name>.md` |
| Tool documentation | `docs/tools-reference.md` |
| Plans (in progress) | `docs/plans/<name>.md` |

### Documentation Template

```markdown
# Feature Name

Brief description.

## Overview

What this feature does and why it exists.

## Usage

How to use it with examples.

## Implementation Details

How it works internally.

## See Also

- Related features
- Related skills
```

### Updating the Index

Add new docs to `docs/README.md` index.

## Workflow for New Features

Follow the SDLC pattern:

1. **Plan**: Understand what you're building and where it fits
2. **Build**: Create the skill/tool/feature
3. **Test**: Verify it works (manually or with tests)
4. **Document**: Update relevant docs
5. **Ship**: `git add . && git commit -m "Add feature X" && git push`
6. **Restart**: If bridge code changed, restart the service

## Checklist

Before marking a new feature complete:

- [ ] Code implemented and working
- [ ] Tests added (if applicable)
- [ ] Documentation updated
- [ ] CLAUDE.md updated (if affects core workflow)
- [ ] Changes committed and pushed
- [ ] Service restarted (if runtime code changed)

## See Also

- Run `/prime` for codebase orientation
- See `docs/tools-reference.md` for tool documentation
- Check `.claude/skills/` for skill examples

登录后下载/点赞/收藏 ❤ 8 | ★ 0

add-feature

目录结构

SKILL.md

举报内容

提示